chore(chat-history): refresh WINDSURF archive artifacts (workflows, env audit, repos)
This commit is contained in:
saravanakumardb1
parent
305d3d7eaa
commit
1846201364
@ -1,9 +1,9 @@
|
||||
Last refresh: 2026-05-23T06:00:12Z (2026-05-22 23:00:12 PDT)
|
||||
Cascade conversations: 50 (438M)
|
||||
Memories: 137
|
||||
Last refresh: 2026-05-29T17:09:25Z (2026-05-29 10:09:25 PDT)
|
||||
Cascade conversations: 50 (502M)
|
||||
Memories: 138
|
||||
Implicit context: 20
|
||||
Code tracker dirs: 14
|
||||
File edit history: 5093 entries
|
||||
Workspace storage: 49 workspaces
|
||||
Code tracker dirs: 43
|
||||
File edit history: 5395 entries
|
||||
Workspace storage: 52 workspaces
|
||||
Repo docs: 7 files across 2 repos
|
||||
Repo workflows: 56 files across 13 repos
|
||||
|
||||
@ -21,8 +21,7 @@ Auto-discovers new repos, updates symlinks, and re-copies docs + workflows.
|
||||
| `learning_ai_notes` | NoteLett | ✅ | — |
|
||||
| `learning_ai_flowmonk` | FlowMonk | ✅ | — |
|
||||
| `learning_ai_trails` | ActionTrail | ✅ | — |
|
||||
| `learning_ai_smart_auth` | SmartAuth | ✅ | — |
|
||||
| `learning_ai_auth_app` | ByteLyst Auth | ✅ | — |
|
||||
| `learning_ai_auth_app` | ByteLyst SmartAuth | ✅ | — |
|
||||
| `learning_ai_productivity_web` | Productivity Tools | ✅ | — |
|
||||
|
||||
## Steps
|
||||
|
||||
@ -1,54 +1,116 @@
|
||||
---
|
||||
description: Regenerate AI agent docs (AGENTS.md, CLAUDE.md, .cursorrules, etc.) across all repos
|
||||
description: Regenerate AI agent docs across all repos (single source of truth pattern)
|
||||
---
|
||||
|
||||
# Update Agent Docs Across Workspace
|
||||
|
||||
Regenerates all 8 AI agent configuration files across all repos in the workspace.
|
||||
Maintains AI agent docs across the ByteLyst workspace using a
|
||||
**single source of truth** pattern with **zero duplication**.
|
||||
|
||||
## Files Generated Per Repo
|
||||
## Architecture
|
||||
|
||||
| File | Tool |
|
||||
| --------------------------------- | ----------------------------------------------- |
|
||||
| `AGENTS.md` | Universal (OpenAI Codex, Claude, Copilot, etc.) |
|
||||
| `CLAUDE.md` | Claude Code |
|
||||
| `.cursorrules` | Cursor AI |
|
||||
| `.github/copilot-instructions.md` | GitHub Copilot |
|
||||
| `.windsurfrules` | Windsurf / Cascade |
|
||||
| `.clinerules` | Cline / Roo Code |
|
||||
| `.aider.conf.yml` | Aider |
|
||||
| `.editorconfig` | All editors |
|
||||
```
|
||||
learning_ai_common_plat/AI.dev/SKILLS/
|
||||
├── agent-behavior-guidelines.md ← SINGLE source of truth for behavior rules
|
||||
└── agent-onboarding.md ← Read-order index for agents
|
||||
|
||||
<each repo>/
|
||||
├── AGENTS.md ← Repo-specific only. Auto-prepended with
|
||||
│ "Read first" pointer to canonical file.
|
||||
├── .github/copilot-instructions.md ← Thin pointer (no rules). Auto-generated.
|
||||
├── .aider.conf.yml ← Aider config pointing to AGENTS.md. Auto-generated.
|
||||
└── .editorconfig ← Editor config. Auto-generated.
|
||||
|
||||
DELETED across all repos (content was duplicated AGENTS.md):
|
||||
├── CLAUDE.md
|
||||
├── .cursorrules
|
||||
├── .windsurfrules
|
||||
└── .clinerules
|
||||
```
|
||||
|
||||
## Steps
|
||||
|
||||
1. Run the update script:
|
||||
1. **Edit the canonical sources** when behavior rules change:
|
||||
|
||||
```bash
|
||||
cd /Users/sd9235/code/mygh/learning_ai_common_plat
|
||||
./scripts/update-agent-docs.sh
|
||||
```
|
||||
```bash
|
||||
# ecosystem-wide agent behavior (Karpathy + ByteLyst)
|
||||
open learning_ai_common_plat/AI.dev/SKILLS/agent-behavior-guidelines.md
|
||||
|
||||
The script reads `learning_ai_common_plat/.windsurf/workflows/repos.txt` as the canonical list of managed workspace repositories.
|
||||
# read-order index
|
||||
open learning_ai_common_plat/AI.dev/SKILLS/agent-onboarding.md
|
||||
```
|
||||
|
||||
2. Review changes per repo:
|
||||
These are referenced (not copied) by every repo's AGENTS.md, so changes
|
||||
take effect immediately — no regeneration needed when only behavior rules change.
|
||||
|
||||
```bash
|
||||
while IFS= read -r repo; do
|
||||
2. **Run the generator** to delete legacy files / refresh pointers / sync configs:
|
||||
|
||||
```bash
|
||||
cd /Users/sd9235/code/mygh/learning_ai_common_plat
|
||||
./scripts/update-agent-docs.sh --dry-run # preview
|
||||
./scripts/update-agent-docs.sh # apply + commit per repo
|
||||
./scripts/update-agent-docs.sh --no-commit # apply without committing
|
||||
```
|
||||
|
||||
Reads `learning_ai_common_plat/.windsurf/workflows/repos.txt` as the
|
||||
canonical list of managed repos.
|
||||
|
||||
3. **Verify no drift**:
|
||||
|
||||
```bash
|
||||
bash scripts/check-agent-docs-drift.sh
|
||||
```
|
||||
|
||||
Exits 1 if any repo has drifted from the canonical generator output.
|
||||
Suitable for CI.
|
||||
|
||||
4. **Review changes per repo**:
|
||||
|
||||
```bash
|
||||
while IFS= read -r repo; do
|
||||
[[ -z "$repo" || "$repo" =~ ^# ]] && continue
|
||||
cd /Users/sd9235/code/mygh/$repo && git diff --stat
|
||||
done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt
|
||||
```
|
||||
echo "── $repo ──"
|
||||
git -C /Users/sd9235/code/mygh/"$repo" log -1 --oneline
|
||||
done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt
|
||||
```
|
||||
|
||||
3. Commit changes (if any):
|
||||
5. **Push (when ready)**:
|
||||
|
||||
```bash
|
||||
cd /Users/sd9235/code/mygh/learning_voice_ai_agent
|
||||
[ -n "$(git status --porcelain)" ] && git add -A && git commit -m "chore(docs): update agent configuration files"
|
||||
```
|
||||
```bash
|
||||
while IFS= read -r repo; do
|
||||
[[ -z "$repo" || "$repo" =~ ^# ]] && continue
|
||||
git -C /Users/sd9235/code/mygh/"$repo" push
|
||||
done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt
|
||||
```
|
||||
|
||||
## Files generated per repo
|
||||
|
||||
| File | Type | Tool(s) |
|
||||
| --------------------------------- | ------- | -------------------------------------- |
|
||||
| `AGENTS.md` | Hybrid | Codex, Claude, Cursor, Windsurf, Cline |
|
||||
| `.github/copilot-instructions.md` | Pointer | GitHub Copilot |
|
||||
| `.aider.conf.yml` | Config | Aider |
|
||||
| `.editorconfig` | Config | All editors |
|
||||
|
||||
`AGENTS.md` is hybrid: the body is hand-maintained (repo-specific content),
|
||||
but the generator idempotently prepends a `<!-- BEGIN: canonical-behavior-pointer -->`
|
||||
block at the top. The block is the only auto-managed region; everything else
|
||||
is left alone.
|
||||
|
||||
## Files deleted by the generator
|
||||
|
||||
| File | Reason |
|
||||
| ---------------- | ------------------------------------------------------------- |
|
||||
| `CLAUDE.md` | Duplicated AGENTS.md. Claude Code reads AGENTS.md by default. |
|
||||
| `.cursorrules` | Duplicated AGENTS.md. Cursor reads AGENTS.md. |
|
||||
| `.windsurfrules` | Duplicated AGENTS.md. Windsurf reads AGENTS.md. |
|
||||
| `.clinerules` | Duplicated AGENTS.md. Cline reads AGENTS.md. |
|
||||
|
||||
## Notes
|
||||
|
||||
- The script scans each repo's structure and regenerates docs based on current state
|
||||
- Only commits if there are actual changes
|
||||
- Safe to run repeatedly (idempotent)
|
||||
- Requires `learning_ai_common_plat` to be the source of truth for templates
|
||||
- Safe to run repeatedly (idempotent).
|
||||
- Only commits when actual changes exist in the repo.
|
||||
- The script never touches the body of AGENTS.md outside the marker block.
|
||||
- For workspaces that include `learning_ai_common_plat` as a sibling
|
||||
(default for Windsurf/Cascade), the canonical guidelines file resolves
|
||||
via the relative path written into each AGENTS.md pointer.
|
||||
|
||||
@ -19,16 +19,21 @@ learning_ai_trails
|
||||
learning_ai_local_memory_gpt
|
||||
learning_ai_efforise
|
||||
learning_ai_local_llms
|
||||
learning_ai_talk2obsidian
|
||||
|
||||
# --- Auth & identity ---
|
||||
learning_ai_smart_auth
|
||||
learning_ai_auth_app
|
||||
|
||||
# --- Web & misc ---
|
||||
learning_ai_productivity_web
|
||||
|
||||
# --- OSS (subdirectory repos under oss/) ---
|
||||
oss/learning_ai_claw-code-oss
|
||||
# NOTE: oss/learning_ai_claw-code-oss is intentionally OMITTED. It is an
|
||||
# upstream Anthropic Claude Code OSS clone with its own CLAUDE.md convention
|
||||
# (auto-generated by Claude Code's bootstrap, not the deprecated ByteLyst
|
||||
# per-product CLAUDE.md pattern). We do not manage its agent docs; deleting
|
||||
# CLAUDE.md or forcing the ByteLyst canonical pointer block would diverge
|
||||
# from upstream alignment for no benefit.
|
||||
oss/learning_ai_claw-cowork
|
||||
|
||||
# -- tooling --
|
||||
|
||||
@ -46,8 +46,7 @@ All code across the ByteLyst workspace repos:
|
||||
- learning_ai_peakpulse (PeakPulse)
|
||||
- learning_ai_notes (NoteLett)
|
||||
- learning_ai_trails (ActionTrail)
|
||||
- learning_ai_smart_auth (SmartAuth)
|
||||
- learning_ai_auth_app (ByteLyst Auth)
|
||||
- learning_ai_auth_app (ByteLyst SmartAuth — companion app + PRD/roadmap)
|
||||
- learning_ai_productivity_web (Productivity Tools)
|
||||
|
||||
## Domain Context
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
---
|
||||
description: "Window 1: Phase 0 scaffolding + Manus cleanup (RUN FIRST — other windows depend on this)"
|
||||
description: 'Window 1: Phase 0 scaffolding + Manus cleanup (RUN FIRST — other windows depend on this)'
|
||||
---
|
||||
|
||||
# Window 1: Phase 0 Scaffolding + Manus Cleanup
|
||||
@ -38,18 +38,20 @@ Create `shared/product.json` following the ecosystem pattern. Use NoteLett (`../
|
||||
}
|
||||
```
|
||||
|
||||
## Step 2: Create Agent Config Files (8 files)
|
||||
## Step 2: Create Agent Config Files (single-source-of-truth pattern)
|
||||
|
||||
Create all 8 agent config files matching ecosystem standard. Copy structure from `../learning_ai_notes/` or `../learning_ai_trails/`:
|
||||
Hand-write `AGENTS.md` only. All other agent files are generated by the
|
||||
canonical script. Legacy files (`CLAUDE.md`, `.cursorrules`, `.windsurfrules`,
|
||||
`.clinerules`) are **deprecated** and must NOT be created — they used to
|
||||
duplicate AGENTS.md content and drifted.
|
||||
|
||||
1. `AGENTS.md` — AI agent onboarding guide (customize for efforise: Vite SPA + Fastify backend, productId efforise, port 4020, --er-* tokens)
|
||||
2. `CLAUDE.md` — Claude Code instructions (short version pointing to AGENTS.md)
|
||||
3. `.windsurfrules` — Windsurf rules (short version pointing to AGENTS.md)
|
||||
4. `.cursorrules` — Cursor rules (short version pointing to AGENTS.md)
|
||||
5. `.clinerules` — Cline rules (short version pointing to AGENTS.md)
|
||||
6. `.aider.conf.yml` — Aider config
|
||||
7. `.editorconfig` — Copy from any ecosystem repo
|
||||
8. `.github/copilot-instructions.md` — GitHub Copilot rules
|
||||
1. `AGENTS.md` — AI agent onboarding guide (customize for efforise: Vite SPA + Fastify backend, productId efforise, port 4020, --er-\* tokens). Copy structure from `../learning_ai_notes/AGENTS.md` or `../learning_ai_trails/AGENTS.md`.
|
||||
2. Add this repo to `../learning_ai_common_plat/.windsurf/workflows/repos.txt` if not already present.
|
||||
3. Run `bash ../learning_ai_common_plat/scripts/update-agent-docs.sh`. This will:
|
||||
- Prepend the canonical-behavior-pointer block to `AGENTS.md`
|
||||
- Generate `.editorconfig`, `.aider.conf.yml`, `.github/copilot-instructions.md`
|
||||
- Verify no legacy files exist (deletes them if present)
|
||||
4. Verify with `bash ../learning_ai_common_plat/scripts/check-agent-docs-drift.sh`.
|
||||
|
||||
## Step 3: Create Root Config Files
|
||||
|
||||
@ -70,12 +72,14 @@ Create all 8 agent config files matching ecosystem standard. Copy structure from
|
||||
## Step 4: Manus Artifact Cleanup
|
||||
|
||||
### 4a. Clean `vite.config.ts`
|
||||
|
||||
- Remove `vite-plugin-manus-runtime` plugin
|
||||
- Remove `vite-plugin-manus-debug-collector` plugin + all LOG_DIR code
|
||||
- Remove `@builder.io/vite-plugin-jsx-loc` plugin
|
||||
- Replace `allowedHosts: [".manuspre.computer", ...]` with `allowedHosts: ["localhost"]`
|
||||
|
||||
### 4b. Delete Manus Files
|
||||
|
||||
- Delete `client/src/components/ManusDialog.tsx`
|
||||
- Delete `client/src/components/Map.tsx` (Google Maps boilerplate, 156 lines)
|
||||
- Delete `client/public/__manus__/` directory (contains `debug-collector.js`)
|
||||
@ -86,21 +90,25 @@ Create all 8 agent config files matching ecosystem standard. Copy structure from
|
||||
- Delete `patches/wouter@3.7.1.patch` (evaluate first — remove if not critical)
|
||||
|
||||
### 4c. Clean `client/index.html`
|
||||
|
||||
- Remove `VITE_ANALYTICS_ENDPOINT` / `VITE_ANALYTICS_WEBSITE_ID` script references
|
||||
|
||||
### 4d. Dependency Cleanup in `package.json`
|
||||
- **Downgrade** `zod` from `^4.1.12` → `^3.24.2` (CRITICAL — Zod 4 breaks @bytelyst/* integration)
|
||||
|
||||
- **Downgrade** `zod` from `^4.1.12` → `^3.24.2` (CRITICAL — Zod 4 breaks @bytelyst/\* integration)
|
||||
- **Upgrade** `typescript` from `5.6.3` → `^5.7.3`
|
||||
- **Remove:** `streamdown`, `cmdk`, `add` (devDep), `@types/google.maps` (devDep), `next-themes`
|
||||
- **Remove:** `express`, `@types/express` (server/ is deleted)
|
||||
- **Remove** Manus vite plugins from devDeps: `vite-plugin-manus-runtime`, `@builder.io/vite-plugin-jsx-loc`
|
||||
|
||||
### 4e. Move Files
|
||||
|
||||
- Move `ideas.md` → `docs/ideas.md`
|
||||
|
||||
## Step 5: Create README.md
|
||||
|
||||
Write a proper README.md with:
|
||||
|
||||
- Product name + description
|
||||
- Tech stack (Vite + React 19 SPA, Fastify 5 backend planned)
|
||||
- Setup instructions (`pnpm install`, `pnpm dev`)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user