From dbfe812adca8a0cb0d4bb8a0d663c8ca62bd4b3d Mon Sep 17 00:00:00 2001 From: tt-a1i Date: Wed, 4 Mar 2026 10:12:13 +0800 Subject: [PATCH] Fix docs links and sync tooling consistency --- .../references/examples.md | 8 ++--- .agent/skills/planning-with-files/examples.md | 8 ++--- .../references/examples.md | 8 ++--- .../references/examples.md | 8 ++--- .../skills/planning-with-files/examples.md | 8 ++--- .../skills/planning-with-files/examples.md | 8 ++--- .../skills/planning-with-files/examples.md | 8 ++--- .../references/examples.md | 8 ++--- .../skills/planning-with-files/examples.md | 8 ++--- .../references/examples.md | 8 ++--- .../references/examples.md | 8 ++--- .../skills/planning-with-files/examples.md | 8 ++--- .pi/skills/planning-with-files/examples.md | 8 ++--- README.md | 2 +- docs/factory.md | 4 +-- docs/opencode.md | 2 +- scripts/sync-ide-folders.py | 30 ++++++++++++++++--- skills/planning-with-files/examples.md | 8 ++--- 18 files changed, 86 insertions(+), 64 deletions(-) diff --git a/.adal/skills/planning-with-files/references/examples.md b/.adal/skills/planning-with-files/references/examples.md index 51b5f3a..728acf4 100644 --- a/.adal/skills/planning-with-files/references/examples.md +++ b/.adal/skills/planning-with-files/references/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.agent/skills/planning-with-files/examples.md b/.agent/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/.agent/skills/planning-with-files/examples.md +++ b/.agent/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.codebuddy/skills/planning-with-files/references/examples.md b/.codebuddy/skills/planning-with-files/references/examples.md index 51b5f3a..728acf4 100644 --- a/.codebuddy/skills/planning-with-files/references/examples.md +++ b/.codebuddy/skills/planning-with-files/references/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.codex/skills/planning-with-files/references/examples.md b/.codex/skills/planning-with-files/references/examples.md index 51b5f3a..728acf4 100644 --- a/.codex/skills/planning-with-files/references/examples.md +++ b/.codex/skills/planning-with-files/references/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.continue/skills/planning-with-files/examples.md b/.continue/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/.continue/skills/planning-with-files/examples.md +++ b/.continue/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.cursor/skills/planning-with-files/examples.md b/.cursor/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/.cursor/skills/planning-with-files/examples.md +++ b/.cursor/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.factory/skills/planning-with-files/examples.md b/.factory/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/.factory/skills/planning-with-files/examples.md +++ b/.factory/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.gemini/skills/planning-with-files/references/examples.md b/.gemini/skills/planning-with-files/references/examples.md index 51b5f3a..728acf4 100644 --- a/.gemini/skills/planning-with-files/references/examples.md +++ b/.gemini/skills/planning-with-files/references/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.kilocode/skills/planning-with-files/examples.md b/.kilocode/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/.kilocode/skills/planning-with-files/examples.md +++ b/.kilocode/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.mastracode/skills/planning-with-files/references/examples.md b/.mastracode/skills/planning-with-files/references/examples.md index 51b5f3a..728acf4 100644 --- a/.mastracode/skills/planning-with-files/references/examples.md +++ b/.mastracode/skills/planning-with-files/references/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.openclaw/skills/planning-with-files/references/examples.md b/.openclaw/skills/planning-with-files/references/examples.md index 51b5f3a..728acf4 100644 --- a/.openclaw/skills/planning-with-files/references/examples.md +++ b/.openclaw/skills/planning-with-files/references/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.opencode/skills/planning-with-files/examples.md b/.opencode/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/.opencode/skills/planning-with-files/examples.md +++ b/.opencode/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/.pi/skills/planning-with-files/examples.md b/.pi/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/.pi/skills/planning-with-files/examples.md +++ b/.pi/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts diff --git a/README.md b/README.md index eea6592..a6b4054 100644 --- a/README.md +++ b/README.md @@ -91,7 +91,7 @@ When your context fills up and you run `/clear`, this skill **automatically reco | Cursor | ✅ Full Support | [Cursor Setup](docs/cursor.md) | Skills + Hooks | | Continue | ✅ Full Support | [Continue Setup](docs/continue.md) | Skills + Prompt files | | Kilocode | ✅ Full Support | [Kilocode Setup](docs/kilocode.md) | Skills | -| OpenCode | ✅ Full Support | [OpenCode Setup](docs/opencode.md) | Personal/Project Skill | +| OpenCode | ⚠️ Partial Support | [OpenCode Setup](docs/opencode.md) | Personal/Project Skill (session catchup limited) | | Codex | ✅ Full Support | [Codex Setup](docs/codex.md) | Personal Skill | | FactoryAI Droid | ✅ Full Support | [Factory Setup](docs/factory.md) | Workspace/Personal Skill | | Antigravity | ✅ Full Support | [Antigravity Setup](docs/antigravity.md) | Workspace/Personal Skill | diff --git a/docs/factory.md b/docs/factory.md index 5315509..227d322 100644 --- a/docs/factory.md +++ b/docs/factory.md @@ -248,5 +248,5 @@ Factory Droid will reference them automatically. - [Quick Start Guide](quickstart.md) - [Workflow Diagram](workflow.md) -- [Manus Principles](../skills/planning-with-files/references.md) -- [Real Examples](../skills/planning-with-files/examples.md) +- [Manus Principles](../.factory/skills/planning-with-files/references.md) +- [Real Examples](../.factory/skills/planning-with-files/examples.md) diff --git a/docs/opencode.md b/docs/opencode.md index c00823d..0166a20 100644 --- a/docs/opencode.md +++ b/docs/opencode.md @@ -6,7 +6,7 @@ planning-with-files works with OpenCode as a personal or project skill. ## Installation -See [.opencode/INSTALL.md](../.opencode/INSTALL.md) for detailed installation instructions. +See [docs/installation.md](installation.md) for detailed installation instructions. ### Quick Install (Global) diff --git a/scripts/sync-ide-folders.py b/scripts/sync-ide-folders.py index 1ab43c6..da116f7 100644 --- a/scripts/sync-ide-folders.py +++ b/scripts/sync-ide-folders.py @@ -19,7 +19,7 @@ Use --dry-run to preview changes without writing anything. Use --verify to check for drift without making changes (exits 1 if drift found). """ -import os +import argparse import shutil import sys import hashlib @@ -226,9 +226,31 @@ def sync_file(src, dst, *, dry_run=False): # ─── Main ────────────────────────────────────────────────────────── -def main(): - dry_run = "--dry-run" in sys.argv - verify = "--verify" in sys.argv +def parse_args(argv=None): + """Parse CLI arguments for sync behavior.""" + parser = argparse.ArgumentParser( + description=( + "Sync shared planning-with-files assets from canonical source " + "to IDE-specific folders." + ) + ) + parser.add_argument( + "--dry-run", + action="store_true", + help="Preview changes without writing files.", + ) + parser.add_argument( + "--verify", + action="store_true", + help="Check for drift only; exit with code 1 if drift is found.", + ) + return parser.parse_args(argv) + + +def main(argv=None): + args = parse_args(argv) + dry_run = args.dry_run + verify = args.verify # Must run from repo root if not CANONICAL.exists(): diff --git a/skills/planning-with-files/examples.md b/skills/planning-with-files/examples.md index 51b5f3a..728acf4 100644 --- a/skills/planning-with-files/examples.md +++ b/skills/planning-with-files/examples.md @@ -34,14 +34,14 @@ Create a research summary on the benefits of morning exercise. ```bash Read task_plan.md # Refresh goals WebSearch "morning exercise benefits" -Write notes.md # Store findings +Write findings.md # Store findings Edit task_plan.md # Mark Phase 2 complete ``` ### Loop 3: Synthesize ```bash Read task_plan.md # Refresh goals -Read notes.md # Get findings +Read findings.md # Get findings Write morning_exercise_summary.md Edit task_plan.md # Mark Phase 3 complete ``` @@ -120,9 +120,9 @@ Add functional dark mode toggle to settings. **Currently in Phase 3** - Building toggle component ``` -**notes.md:** +**findings.md:** ```markdown -# Notes: Dark Mode Implementation +# Findings: Dark Mode Implementation ## Existing Theme System - Located in: src/styles/theme.ts