mirror of
https://github.com/boshu2/agentops.git
synced 2026-09-14 15:08:13 +08:00
boshu
4a7c6a0701
Add an --all-docs mode to check-doc-skill-refs.sh that scans the union of the pinned doctrine files PLUS the full LIVE docs/** set (scripts/lib/docs-scope.sh), ratcheted by a new filename-pinned shrink baseline (scripts/.docs-skill-refs-baseline). Two-way ratchet: a non-baselined live doc with a dead `/skill` ref FAILS; a baselined file that no longer offends FAILS demanding a prune. Detection stays slash-syntax + headings only (never bare skill names). Default (no-flag) behavior is byte-identical. docs/SKILL-ROUTER.md (the curated router) is covered by --all-docs (a live docs/** file, never baselined) so a dead ref there FAILS strict, without perturbing the byte-identical default doc count. seed.go docs.skill-refs row: Match widened to docs/** + the baseline + the lib; Args set to [--all-docs --strict]. Burn-down (long-tail only): repointed retired `/retro`->/post-mortem, `/vibe`->/validate, `/ratchet`->/flywheel, `/research-multi`->/research, `/implement-wave`->/crank, and reworded the retired `/dream` across 13 docs/levels + docs/workflows + docs/philosophy pages, then pruned them from the baseline (91 -> 78 offenders). Owner-locked pages (comparisons/getting-started/positioning) stay baselined. Bats twin tests/scripts/check-doc-skill-refs-all-docs.bats covers all the modes.
L2 — Persistence
Add the .agents/ directory for cross-session memory.
What You'll Learn
- Creating
.agents/directory structure - Writing research documents that persist
- Extracting learnings with
/post-mortem - Pattern documentation
Prerequisites
- Completed L1-basics
- Comfortable with
/researchand/implement
Available Commands
| Command | Purpose |
|---|---|
/research <topic> |
Output now saved to .agents/research/ |
/implement |
Same as L1 |
/post-mortem [topic] |
Extract learnings to .agents/learnings/ |
Key Concepts
.agents/directory: AI memory system- Research documents: Deep exploration persists
- Learnings: Session insights survive context clear
- Patterns: Reusable solutions accumulate
Directory Structure
.agents/
├── research/ # Deep exploration documents
├── learnings/ # Session insights
└── patterns/ # Reusable solutions
What's NOT at This Level
- No issue tracking
- No parallelization
- No
/crank(autonomous execution)
Next Level
Once comfortable with persistence, progress to L3-state-management to add issue tracking.