Skip to content

Commit a2c7610

Browse files
committed
Revert "templates live docs"
This reverts commit cb3f73f.
1 parent 1801fcd commit a2c7610

5 files changed

Lines changed: 19 additions & 28 deletions

File tree

templates/base/docs/live/progress.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,34 +4,41 @@ Read after `docs/live/current-focus.md` to recover the latest state, continuity,
44

55
## Current State
66

7-
Summarize the current state of the work in 1-2 sentences.
7+
The template skill surface now has a complete top-level discoverability pass: `using-agent-practices` and its category map cover every live top-level skill, including standalone specialist leaves that were previously omitted. No package moves or new router families were needed, so the default next move still returns to Task 35 unless a concrete routing regression appears.
88

99
## Latest Completed Work
1010

11-
- completed item
11+
- completed a full scan of `templates/base/.agents/skills/` and found six live top-level skills missing from the canonical top-level router surface: `create-skill`, `create-router-skill`, `cx-ticket-triage`, `data-exploration`, `visualization`, and `media`
12+
- updated `templates/base/.agents/skills/using-agent-practices/{SKILL.md,references/category-map.md,evals/*}` so those skills are first-class direct routes with explicit boundary language against nearby skills
13+
- updated `templates/base/docs/reference/{codemap.md,memory.md}` to preserve the top-level discoverability rule and the category-map role
14+
- reviewed reference writeback: no `templates/base/docs/reference/{architecture.md,lessons.md}` update was needed because the change tightened top-level discoverability rules without moving package boundaries or adding a new failure-pattern worth preserving
1215

1316
## In Progress
1417

15-
- none
18+
None.
1619

1720
## Blockers
1821

19-
- none
22+
None.
2023

2124
## Next Recommended Action
2225

23-
- Next step:
26+
- Next step: Resume Task 35: refine the capability-based methodology overlays in the finance, research, and webapp docs. Treat the top-level skill audit as landed unless a concrete discoverability regression appears.
2427

2528
## Touched Files
2629

27-
- `path/to/file`
30+
- `templates/base/.agents/skills/using-agent-practices/`
31+
- `templates/base/docs/reference/{codemap.md,memory.md}`
32+
- `templates/base/docs/live/progress.md`
2833

2934
## Verification Status
3035

31-
- Check:
32-
- Result:
36+
- Check: `python3 templates/base/.agents/skills/create-skill/scripts/validate.py --strict templates/base/.agents/skills/using-agent-practices`
37+
- Result: passed
38+
- Check: targeted Python assertions for top-level skill coverage, router outputs, category-map inventory completeness, and eval IDs
39+
- Result: passed
3340

3441
## Hand-off Note
3542

36-
- Resume from:
37-
- Watch for:
43+
- Resume from: `templates/base/.agents/skills/using-agent-practices/` if any top-level routing ambiguity resurfaces; otherwise return to Task 35 work.
44+
- Watch for: future standalone skills added under `templates/base/.agents/skills/` without matching updates to `using-agent-practices/SKILL.md`, `references/category-map.md`, and trigger/task eval coverage.

templates/base/docs/reference/architecture.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -45,9 +45,5 @@ Read when system shape, boundaries, or invariants matter. Keep this focused on s
4545
- Key dependency: an independent evaluator or explicit acceptance pass writing the record as it verifies.
4646

4747
- Component: `.agents/skills/software-delivery/`
48-
- Responsibility: routes non-trivial software work between feature discovery, multi-phase control, harness control, plan reviews, and independent frontend evaluation.
48+
- Responsibility: routes non-trivial software work between feature discovery, harness control, plan reviews, and independent frontend evaluation.
4949
- Key dependency: the request being classified by the dominant delivery need rather than by convenience.
50-
51-
- Component: `.agents/skills/software-delivery/multi-phase-control/`
52-
- Responsibility: preserves roadmap intent across phases with explicit phase gates, drift tracking, compaction checkpoints, and live-doc persistence.
53-
- Key dependency: the control model and baton ownership rules staying aligned with `harness-design` and `context-compaction`.

templates/base/docs/reference/codemap.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,6 @@ Read when you need to find where to work. Prefer only high-value paths.
1616
- Purpose: router family for feature discovery, harness control, plan reviews, and independent frontend evaluation.
1717
- Update when: a software-delivery leaf is added, removed, renamed, or materially repurposed.
1818

19-
- Path: `templates/base/.agents/skills/software-delivery/multi-phase-control/`
20-
- Purpose: leaf skill for phase-gated persistence, drift tracking, and cross-session roadmap continuity.
21-
- Update when: the multi-phase workflow, templates, or router bindings change.
22-
2319
- Path: `templates/base/.agents/skills/using-reasoning/`
2420
- Purpose: router family for analytical requests across state calibration, problem framing, strategic foresight, hidden-rule reality checks, structured advisory, and multi-lens analysis.
2521
- Update when: a reasoning leaf is added, removed, renamed, or materially repurposed.
@@ -41,7 +37,7 @@ Read when you need to find where to work. Prefer only high-value paths.
4137

4238
- Entrypoint: `templates/base/.agents/skills/software-delivery/SKILL.md`
4339
- Consumer: agents choosing the right software-delivery lane
44-
- Notes: routes to `feature-discovery`, `multi-phase-control`, `harness-design`, `plan-product-review`, `plan-engineering-review`, `plan-design-review`, or `frontend-evaluator`.
40+
- Notes: routes to `feature-discovery`, `harness-design`, `plan-product-review`, `plan-engineering-review`, `plan-design-review`, or `frontend-evaluator`.
4541

4642
- Entrypoint: `templates/base/.agents/skills/using-reasoning/SKILL.md`
4743
- Consumer: agents choosing the right reasoning lane for analytical, strategic, or diagnostic requests

templates/base/docs/reference/lessons.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,3 @@ Read after mistakes, rework, or surprises. Capture only reusable lessons.
1717
- Fix:
1818
- When to apply:
1919
- Evidence:
20-
21-
- Fix: write router and skill edits under `templates/base/`, not the user-home copy, and remove any accidental repo-root `.agents/` duplicate before verifying.
22-
- When to apply: whenever scaffolding or copying skill packages in this repository.
23-
- Evidence: this task initially wrote to the wrong location and left a duplicate tree until the repo-root copy was deleted.

templates/base/docs/reference/memory.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,3 @@ Read for durable truths worth preserving across sessions. Do not store transient
1212
- Decision: `using-agent-practices` is the canonical top-level discoverability router for the template skill suite, and its `references/category-map.md` inventory must stay in sync with every live top-level skill under `templates/base/.agents/skills/`.
1313
- Preserve because: missing standalone leaves in the top-level router create silent discovery holes even when the skills themselves are valid and present on disk.
1414
- Revisit only if: the template adopts a different top-level discovery mechanism or moves standalone specialist skills behind a new explicit family router.
15-
16-
- Decision: `software-delivery/multi-phase-control` is the canonical leaf for phase-gated roadmap persistence and drift prevention, and `software-delivery` routes to it before `harness-design` when preserving original intent across phases is the primary need.
17-
- Preserve because: multi-phase work fails when original intent lives only in chat context instead of an explicit persistence workflow.
18-
- Revisit only if: phase preservation becomes part of another router or a new control model replaces the current multi-phase workflow.

0 commit comments

Comments
 (0)