@event4u/agent-config 1.16.0 → 1.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agent-src/commands/{agents-audit.md → agents/audit.md} +4 -3
- package/.agent-src/commands/{agents-cleanup.md → agents/cleanup.md} +12 -6
- package/.agent-src/commands/{agents-prepare.md → agents/prepare.md} +4 -3
- package/.agent-src/commands/agents.md +46 -0
- package/.agent-src/commands/{chat-history-checkpoint.md → chat-history/checkpoint.md} +4 -4
- package/.agent-src/commands/{chat-history-clear.md → chat-history/clear.md} +4 -4
- package/.agent-src/commands/{chat-history-resume.md → chat-history/resume.md} +4 -4
- package/.agent-src/commands/chat-history/show.md +107 -0
- package/.agent-src/commands/chat-history.md +33 -89
- package/.agent-src/commands/{commit-in-chunks.md → commit/in-chunks.md} +15 -13
- package/.agent-src/commands/commit.md +22 -2
- package/.agent-src/commands/{context-create.md → context/create.md} +4 -3
- package/.agent-src/commands/{context-refactor.md → context/refactor.md} +4 -3
- package/.agent-src/commands/context.md +44 -0
- package/.agent-src/commands/{copilot-agents-init.md → copilot-agents/init.md} +4 -3
- package/.agent-src/commands/{copilot-agents-optimize.md → copilot-agents/optimize.md} +4 -3
- package/.agent-src/commands/copilot-agents.md +44 -0
- package/.agent-src/commands/council/default.md +221 -0
- package/.agent-src/commands/{council-design.md → council/design.md} +6 -5
- package/.agent-src/commands/{council-optimize.md → council/optimize.md} +7 -6
- package/.agent-src/commands/{council-pr.md → council/pr.md} +6 -5
- package/.agent-src/commands/council.md +47 -212
- package/.agent-src/commands/{create-pr-description.md → create-pr/description-only.md} +4 -2
- package/.agent-src/commands/create-pr.md +26 -5
- package/.agent-src/commands/{feature-dev.md → feature/dev.md} +5 -10
- package/.agent-src/commands/{feature-explore.md → feature/explore.md} +4 -8
- package/.agent-src/commands/{feature-plan.md → feature/plan.md} +4 -8
- package/.agent-src/commands/{feature-refactor.md → feature/refactor.md} +4 -8
- package/.agent-src/commands/{feature-roadmap.md → feature/roadmap.md} +6 -10
- package/.agent-src/commands/feature.md +6 -12
- package/.agent-src/commands/{fix-ci.md → fix/ci.md} +4 -8
- package/.agent-src/commands/{fix-portability.md → fix/portability.md} +4 -8
- package/.agent-src/commands/{fix-pr-bot-comments.md → fix/pr-bots.md} +4 -8
- package/.agent-src/commands/{fix-pr-developer-comments.md → fix/pr-developers.md} +4 -8
- package/.agent-src/commands/{fix-pr-comments.md → fix/pr.md} +7 -11
- package/.agent-src/commands/{fix-references.md → fix/refs.md} +4 -8
- package/.agent-src/commands/{fix-seeder.md → fix/seeder.md} +4 -8
- package/.agent-src/commands/fix.md +7 -13
- package/.agent-src/commands/{do-and-judge.md → judge/on-diff.md} +4 -3
- package/.agent-src/commands/judge/solo.md +90 -0
- package/.agent-src/commands/{do-in-steps.md → judge/steps.md} +4 -3
- package/.agent-src/commands/judge.md +35 -70
- package/.agent-src/commands/{memory-add.md → memory/add.md} +4 -3
- package/.agent-src/commands/{memory-full.md → memory/load.md} +4 -3
- package/.agent-src/commands/{memory-promote.md → memory/promote.md} +4 -3
- package/.agent-src/commands/{propose-memory.md → memory/propose.md} +4 -3
- package/.agent-src/commands/memory.md +48 -0
- package/.agent-src/commands/{module-create.md → module/create.md} +4 -3
- package/.agent-src/commands/{module-explore.md → module/explore.md} +4 -3
- package/.agent-src/commands/module.md +44 -0
- package/.agent-src/commands/{optimize-agents.md → optimize/agents.md} +4 -8
- package/.agent-src/commands/{optimize-augmentignore.md → optimize/augmentignore.md} +4 -9
- package/.agent-src/commands/{optimize-rtk-filters.md → optimize/rtk.md} +4 -8
- package/.agent-src/commands/{optimize-skills.md → optimize/skills.md} +4 -8
- package/.agent-src/commands/optimize.md +4 -10
- package/.agent-src/commands/{override-create.md → override/create.md} +4 -3
- package/.agent-src/commands/{override-manage.md → override/manage.md} +4 -3
- package/.agent-src/commands/override.md +44 -0
- package/.agent-src/commands/{roadmap-create.md → roadmap/create.md} +4 -3
- package/.agent-src/commands/{roadmap-execute.md → roadmap/execute.md} +4 -3
- package/.agent-src/commands/roadmap.md +44 -0
- package/.agent-src/commands/{tests-create.md → tests/create.md} +4 -3
- package/.agent-src/commands/{tests-execute.md → tests/execute.md} +4 -3
- package/.agent-src/commands/tests.md +44 -0
- package/.agent-src/contexts/communication/rules-auto/artifact-engagement-recording-mechanics.md +72 -0
- package/.agent-src/contexts/communication/rules-auto/augment-portability-mechanics.md +79 -0
- package/.agent-src/contexts/communication/rules-auto/augment-source-of-truth-mechanics.md +98 -0
- package/.agent-src/contexts/communication/rules-auto/cli-output-handling-mechanics.md +87 -0
- package/.agent-src/contexts/communication/rules-auto/command-suggestion-policy-mechanics.md +62 -0
- package/.agent-src/contexts/communication/rules-auto/docs-sync-mechanics.md +78 -0
- package/.agent-src/contexts/communication/rules-auto/package-ci-checks-mechanics.md +85 -0
- package/.agent-src/contexts/communication/rules-auto/review-routing-awareness-mechanics.md +65 -0
- package/.agent-src/contexts/communication/rules-auto/roadmap-progress-sync-mechanics.md +78 -0
- package/.agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +62 -0
- package/.agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +55 -0
- package/.agent-src/contexts/communication/rules-auto/ui-audit-gate-mechanics.md +53 -0
- package/.agent-src/contexts/communication/rules-auto/user-interaction-mechanics.md +77 -0
- package/.agent-src/contexts/judges/no-consolidate-rationale.md +102 -0
- package/.agent-src/contexts/judges/persona-voice-rubric.md +140 -0
- package/.agent-src/rules/artifact-engagement-recording.md +13 -69
- package/.agent-src/rules/ask-when-uncertain.md +27 -42
- package/.agent-src/rules/augment-portability.md +15 -61
- package/.agent-src/rules/augment-source-of-truth.md +27 -93
- package/.agent-src/rules/cli-output-handling.md +10 -76
- package/.agent-src/rules/command-suggestion-policy.md +18 -59
- package/.agent-src/rules/commit-conventions.md +17 -14
- package/.agent-src/rules/context-hygiene.md +6 -0
- package/.agent-src/rules/direct-answers.md +35 -59
- package/.agent-src/rules/docker-commands.md +5 -5
- package/.agent-src/rules/docs-sync.md +15 -69
- package/.agent-src/rules/language-and-tone.md +48 -72
- package/.agent-src/rules/missing-tool-handling.md +28 -22
- package/.agent-src/rules/no-cheap-questions.md +39 -53
- package/.agent-src/rules/no-roadmap-references.md +73 -0
- package/.agent-src/rules/onboarding-gate.md +7 -0
- package/.agent-src/rules/package-ci-checks.md +21 -61
- package/.agent-src/rules/preservation-guard.md +64 -29
- package/.agent-src/rules/review-routing-awareness.md +24 -43
- package/.agent-src/rules/roadmap-progress-sync.md +31 -65
- package/.agent-src/rules/rule-type-governance.md +28 -0
- package/.agent-src/rules/security-sensitive-stop.md +8 -8
- package/.agent-src/rules/skill-quality.md +16 -48
- package/.agent-src/rules/slash-command-routing-policy.md +7 -4
- package/.agent-src/rules/think-before-action.md +52 -42
- package/.agent-src/rules/tool-safety.md +19 -16
- package/.agent-src/rules/ui-audit-gate.md +24 -38
- package/.agent-src/rules/user-interaction.md +13 -68
- package/.agent-src/skills/ai-council/SKILL.md +2 -0
- package/.agent-src/skills/api-testing/SKILL.md +1 -1
- package/.agent-src/skills/check-refs/SKILL.md +59 -40
- package/.agent-src/skills/conventional-commits-writing/SKILL.md +86 -28
- package/.agent-src/skills/copilot-agents-optimization/SKILL.md +5 -5
- package/.agent-src/skills/developer-like-execution/SKILL.md +4 -4
- package/.agent-src/skills/finishing-a-development-branch/SKILL.md +101 -65
- package/.agent-src/skills/flux/SKILL.md +30 -10
- package/.agent-src/skills/github-ci/SKILL.md +2 -2
- package/.agent-src/skills/judge-code-quality/SKILL.md +7 -8
- package/.agent-src/skills/judge-security-auditor/SKILL.md +4 -5
- package/.agent-src/skills/judge-test-coverage/SKILL.md +3 -4
- package/.agent-src/skills/lint-skills/SKILL.md +57 -39
- package/.agent-src/skills/md-language-check/SKILL.md +61 -39
- package/.agent-src/skills/override-management/SKILL.md +5 -5
- package/.agent-src/skills/quality-tools/SKILL.md +2 -2
- package/.agent-src/skills/react-shadcn-ui/SKILL.md +116 -43
- package/.agent-src/skills/readme-reviewer/SKILL.md +30 -29
- package/.agent-src/skills/readme-writing/SKILL.md +78 -53
- package/.agent-src/skills/readme-writing-package/SKILL.md +50 -47
- package/.agent-src/skills/receiving-code-review/SKILL.md +52 -47
- package/.agent-src/skills/refine-prompt/SKILL.md +0 -1
- package/.agent-src/skills/requesting-code-review/SKILL.md +35 -30
- package/.agent-src/skills/security/SKILL.md +7 -2
- package/.agent-src/skills/security-audit/SKILL.md +7 -3
- package/.agent-src/skills/systematic-debugging/SKILL.md +68 -60
- package/.agent-src/skills/test-driven-development/SKILL.md +59 -57
- package/.agent-src/skills/test-performance/SKILL.md +0 -1
- package/.agent-src/skills/traefik/SKILL.md +4 -4
- package/.agent-src/skills/verify-completion-evidence/SKILL.md +28 -26
- package/.agent-src/templates/roadmaps.md +4 -0
- package/.claude-plugin/marketplace.json +22 -11
- package/AGENTS.md +2 -2
- package/CHANGELOG.md +125 -1
- package/README.md +18 -17
- package/docs/architecture.md +4 -6
- package/docs/catalog.md +67 -39
- package/docs/contracts/STABILITY.md +13 -7
- package/docs/contracts/adr-chat-history-split.md +1 -3
- package/docs/contracts/adr-command-suggestion.md +0 -2
- package/docs/contracts/adr-implement-ticket-runtime.md +1 -2
- package/docs/contracts/adr-product-ui-track.md +3 -6
- package/docs/contracts/adr-prompt-driven-execution.md +3 -4
- package/docs/contracts/agent-memory-contract.md +6 -11
- package/docs/contracts/artifact-engagement-flow.md +6 -9
- package/docs/contracts/command-clusters.md +56 -46
- package/docs/contracts/command-suggestion-flow.md +1 -3
- package/docs/contracts/context-paths.md +99 -0
- package/docs/contracts/file-ownership-matrix.json +6722 -0
- package/docs/contracts/file-ownership-matrix.md +134 -0
- package/docs/contracts/implement-ticket-flow.md +6 -9
- package/docs/contracts/linear-ai-rules-inclusion.md +0 -1
- package/docs/contracts/linear-ai-three-layers.md +0 -2
- package/docs/contracts/load-context-budget-model.md +258 -0
- package/docs/contracts/load-context-schema.md +21 -3
- package/docs/contracts/roadmap-complexity-standard.md +137 -0
- package/docs/contracts/rule-interactions.md +0 -1
- package/docs/contracts/rule-priority-hierarchy.md +1 -1
- package/docs/contracts/ui-track-flow.md +7 -17
- package/docs/customization.md +2 -0
- package/docs/getting-started.md +5 -4
- package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +134 -0
- package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +100 -0
- package/docs/guidelines/agent-infra/direct-answers-demos.md +145 -0
- package/docs/guidelines/agent-infra/verify-before-complete-demos.md +128 -0
- package/package.json +1 -1
- package/scripts/_phase2_shim_helper.py +109 -0
- package/scripts/agent-config +30 -0
- package/scripts/ai_council/one_off_archive/2026-05/README.md +45 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_2a4_acceptance.py +208 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +206 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_estimate.py +67 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_review.py +292 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_followups_review.py +259 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_nondestructive_inline_audit.py +209 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase4_dispatch_latency.py +108 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase6_trigger_jaccard.py +92 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_budget_rebalance.py +257 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_post_revert.py +197 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_rule_hardening_v1.py +251 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_open_questions.py +232 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_optimization.py +144 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_v3_gaps.py +252 -0
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_v3_review.py +240 -0
- package/scripts/build_rule_trigger_matrix.py +360 -0
- package/scripts/check_always_budget.py +402 -45
- package/scripts/check_cluster_patterns.py +159 -0
- package/scripts/check_command_count_messaging.py +14 -7
- package/scripts/check_context_paths.py +201 -0
- package/scripts/check_no_roadmap_refs.py +155 -0
- package/scripts/check_one_off_location.py +81 -0
- package/scripts/check_phase_coupling.py +148 -0
- package/scripts/check_portability.py +2 -0
- package/scripts/check_references.py +35 -2
- package/scripts/check_safety_floor_untouched.py +125 -0
- package/scripts/command_suggester/loader.py +4 -1
- package/scripts/compress.py +64 -15
- package/scripts/context_hygiene_hook.py +173 -0
- package/scripts/generate_index.py +6 -2
- package/scripts/generate_ownership_matrix.py +323 -0
- package/scripts/hooks/augment-context-hygiene.sh +55 -0
- package/scripts/hooks/augment-onboarding-gate.sh +55 -0
- package/scripts/hooks/augment-roadmap-progress.sh +57 -0
- package/scripts/install.py +105 -45
- package/scripts/lint_examples.py +98 -0
- package/scripts/lint_no_new_atomic_commands.py +12 -11
- package/scripts/lint_roadmap_complexity.py +127 -0
- package/scripts/onboarding_gate_hook.py +137 -0
- package/scripts/requirements-evals.txt +1 -0
- package/scripts/roadmap_progress_hook.py +159 -0
- package/scripts/schemas/command.schema.json +4 -3
- package/scripts/schemas/rule.schema.json +5 -0
- package/scripts/skill_linter.py +1 -0
- package/scripts/sync_agent_settings.py +25 -2
- package/scripts/update_counts.py +7 -0
- /package/scripts/ai_council/{_one_off_rebalancing_audit.py → one_off_archive/2026-05/_one_off_rebalancing_audit.py} +0 -0
- /package/scripts/ai_council/{_one_off_roundtrip.py → one_off_archive/2026-05/_one_off_roundtrip.py} +0 -0
|
@@ -1,89 +1,54 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: judge
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
description: Judge orchestrator — routes to solo, steps, on-diff
|
|
4
|
+
cluster: judge
|
|
5
5
|
disable-model-invocation: true
|
|
6
6
|
suggestion:
|
|
7
|
-
eligible:
|
|
8
|
-
|
|
7
|
+
eligible: true
|
|
8
|
+
trigger_description: "judge this diff, review with verdict, run an implementer→judge loop, step-by-step judged execution"
|
|
9
|
+
trigger_context: "user wants a verdict on a diff, a do-and-judge loop, or a step-gated execution"
|
|
9
10
|
---
|
|
10
11
|
|
|
11
|
-
# judge
|
|
12
|
+
# /judge
|
|
12
13
|
|
|
13
|
-
|
|
14
|
+
Top-level orchestrator for the `/judge` family. Replaces 3 standalone
|
|
15
|
+
commands with a single entry point + sub-command dispatch.
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
## Sub-commands
|
|
16
18
|
|
|
17
|
-
|
|
19
|
+
| Sub-command | Routes to | Purpose |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| `/judge solo` | `commands/judge/solo.md` | Standalone verdict on an existing diff — no implementer, no revision loop |
|
|
22
|
+
| `/judge on-diff` | `commands/judge/on-diff.md` | Implementer→judge loop on a single change with a two-revision ceiling |
|
|
23
|
+
| `/judge steps` | `commands/judge/steps.md` | Execute an ordered plan step by step, judge gate between steps |
|
|
18
24
|
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
|
|
22
|
-
- A single file or set of files
|
|
25
|
+
Sub-command names match the locked contract in
|
|
26
|
+
[`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
27
|
+
The standalone reviewer surface lives at [`/review`](review-changes.md).
|
|
23
28
|
|
|
24
|
-
|
|
25
|
-
assume the working tree.
|
|
29
|
+
## Dispatch
|
|
26
30
|
|
|
27
|
-
|
|
31
|
+
1. Parse the user's argument: `/judge <sub-command> [args]`.
|
|
32
|
+
2. Look up the sub-command in the table above.
|
|
33
|
+
3. Load the body of the routed file and follow its `## Instructions`
|
|
34
|
+
section verbatim with the remaining args.
|
|
35
|
+
4. If the sub-command is unknown or missing, print the table above and
|
|
36
|
+
ask:
|
|
28
37
|
|
|
29
|
-
|
|
38
|
+
> 1. solo — verdict only, no loop
|
|
39
|
+
> 2. on-diff — implementer→judge revision loop
|
|
40
|
+
> 3. steps — judge gate between ordered steps
|
|
30
41
|
|
|
31
|
-
|
|
32
|
-
- The original task, ticket, or PR description
|
|
33
|
-
- Relevant acceptance criteria (tests, linter config, design doc)
|
|
42
|
+
## Rules
|
|
34
43
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
Read `.agent-settings.yml`:
|
|
41
|
-
|
|
42
|
-
- `subagents.judge_model` → empty = one tier above session model
|
|
43
|
-
|
|
44
|
-
Unknown alias → stop. Silence is not a fallback.
|
|
45
|
-
|
|
46
|
-
### 4. Invoke the judge
|
|
47
|
-
|
|
48
|
-
The judge reviews the diff against the task. Return one of:
|
|
49
|
-
|
|
50
|
-
| Verdict | Meaning |
|
|
51
|
-
|----------|----------------------------------------------|
|
|
52
|
-
| `apply` | Correct, complete, ready to land |
|
|
53
|
-
| `revise` | Specific issues listed — user decides next |
|
|
54
|
-
| `reject` | Fundamentally wrong approach |
|
|
55
|
-
|
|
56
|
-
Unlike `/do-and-judge`, this command does **not** loop — no revision
|
|
57
|
-
cycles. The verdict is the deliverable.
|
|
58
|
-
|
|
59
|
-
### 5. Report
|
|
60
|
-
|
|
61
|
-
```
|
|
62
|
-
Mode: judge (standalone)
|
|
63
|
-
Target: <diff | commit range | PR #N | files>
|
|
64
|
-
Judge: <resolved model>
|
|
65
|
-
Verdict: apply | revise | reject
|
|
66
|
-
Issues: <numbered list if revise/reject>
|
|
67
|
-
Next step: <what the user should do based on the verdict>
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
## Use this command when
|
|
71
|
-
|
|
72
|
-
- A diff already exists and the user wants a second opinion
|
|
73
|
-
- Reviewing someone else's PR before approving it
|
|
74
|
-
- Double-checking a change before opening a PR
|
|
75
|
-
- Stress-testing a refactor without committing to revisions
|
|
76
|
-
|
|
77
|
-
## Do NOT
|
|
78
|
-
|
|
79
|
-
- NEVER apply the diff — this command judges only
|
|
80
|
-
- NEVER loop into a revision cycle — use `/do-and-judge` for that
|
|
81
|
-
- NEVER run the judge on an empty diff — fail fast
|
|
82
|
-
- NEVER silently fall back to the session model for the judge
|
|
44
|
+
- **Do NOT commit, push, or open a PR** unless the sub-command
|
|
45
|
+
explicitly authorizes it.
|
|
46
|
+
- **Do NOT chain sub-commands.** One `/judge <sub>` per turn.
|
|
47
|
+
- If the user invokes `/judge` with no argument, **show the menu** —
|
|
48
|
+
do not guess which sub-command they meant.
|
|
83
49
|
|
|
84
50
|
## See also
|
|
85
51
|
|
|
86
52
|
- [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md)
|
|
87
|
-
- [`/
|
|
88
|
-
- [
|
|
89
|
-
- [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)
|
|
53
|
+
- [`/review`](review-changes.md) — human-oriented self-review (Reviewer-mode contract)
|
|
54
|
+
- [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#reviewer)
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: memory
|
|
2
|
+
name: memory:add
|
|
3
|
+
cluster: memory
|
|
4
|
+
sub: add
|
|
3
5
|
description: Interactively add a validated entry to an engineering-memory file (domain-invariants, architecture-decisions, incident-learnings, product-rules)
|
|
4
6
|
skills: [file-editor]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "post-incident or post-decision conversation"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# /memory
|
|
13
|
-
|
|
14
|
+
# /memory add
|
|
14
15
|
Creates or updates a single entry in one of the four engineering-memory
|
|
15
16
|
YAML files under `agents/memory/` in the consumer project. The entry
|
|
16
17
|
is validated against the schema in
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: memory
|
|
2
|
+
name: memory:load
|
|
3
|
+
cluster: memory
|
|
4
|
+
sub: load
|
|
3
5
|
description: Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analysis, never auto-triggered
|
|
4
6
|
skills: []
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -8,8 +10,7 @@ suggestion:
|
|
|
8
10
|
rationale: "Description states 'never auto-triggered' — opt-in deep-load only."
|
|
9
11
|
---
|
|
10
12
|
|
|
11
|
-
# /memory
|
|
12
|
-
|
|
13
|
+
# /memory load
|
|
13
14
|
Loads every entry of a single memory type into the current conversation
|
|
14
15
|
as a formatted block. Use when the normal `memory_lookup` filter is too
|
|
15
16
|
narrow and you need the full type for an architecture decision, audit,
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: memory
|
|
2
|
+
name: memory:promote
|
|
3
|
+
cluster: memory
|
|
4
|
+
sub: promote
|
|
3
5
|
description: Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the admission gate.
|
|
4
6
|
skills: [file-editor]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -8,8 +10,7 @@ suggestion:
|
|
|
8
10
|
rationale: "Curation pipeline — overlaps /memory-add; keep explicit."
|
|
9
11
|
---
|
|
10
12
|
|
|
11
|
-
# /memory
|
|
12
|
-
|
|
13
|
+
# /memory promote
|
|
13
14
|
Moves an entry from the provisional layer (intake JSONL) into the
|
|
14
15
|
curated layer (`agents/memory/<type>.yml` or sharded). Promotion is
|
|
15
16
|
gated by
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: propose
|
|
2
|
+
name: memory:propose
|
|
3
|
+
cluster: memory
|
|
4
|
+
sub: propose
|
|
3
5
|
description: Append a provisional memory signal to the intake stream — the universal fallback for any producer (human or agent) to record a finding without committing to a curated entry.
|
|
4
6
|
skills: [file-editor]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -8,8 +10,7 @@ suggestion:
|
|
|
8
10
|
rationale: "Programmatic intake fallback — overlaps /memory-add; keep explicit."
|
|
9
11
|
---
|
|
10
12
|
|
|
11
|
-
# /propose
|
|
12
|
-
|
|
13
|
+
# /memory propose
|
|
13
14
|
Drops a **signal** into `agents/memory/intake/signals-YYYY-MM.jsonl` via
|
|
14
15
|
`scripts/memory_signal.py`. Signals are append-only JSONL and merge-safe.
|
|
15
16
|
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: memory
|
|
3
|
+
description: Memory orchestrator — routes to add, load, promote, propose
|
|
4
|
+
cluster: memory
|
|
5
|
+
disable-model-invocation: true
|
|
6
|
+
suggestion:
|
|
7
|
+
eligible: true
|
|
8
|
+
trigger_description: "add a memory entry, load all memories, promote a signal, propose a finding"
|
|
9
|
+
trigger_context: "user wants to write to or curate engineering memory"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# /memory
|
|
13
|
+
|
|
14
|
+
Top-level orchestrator for the `/memory` family. Replaces 4 standalone
|
|
15
|
+
commands with a single entry point + sub-command dispatch.
|
|
16
|
+
|
|
17
|
+
## Sub-commands
|
|
18
|
+
|
|
19
|
+
| Sub-command | Routes to | Purpose |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| `/memory add` | `commands/memory/add.md` | Interactively add a validated entry to a memory file |
|
|
22
|
+
| `/memory load` | `commands/memory/load.md` | Load ALL curated entries of a given memory type into context |
|
|
23
|
+
| `/memory promote` | `commands/memory/promote.md` | Promote an intake signal to a curated memory entry |
|
|
24
|
+
| `/memory propose` | `commands/memory/propose.md` | Append a provisional signal to the intake stream |
|
|
25
|
+
|
|
26
|
+
Sub-command names match the locked contract in
|
|
27
|
+
[`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
28
|
+
|
|
29
|
+
## Dispatch
|
|
30
|
+
|
|
31
|
+
1. Parse the user's argument: `/memory <sub-command> [args]`.
|
|
32
|
+
2. Look up the sub-command in the table above.
|
|
33
|
+
3. Load the body of the routed file and follow its `## Instructions` section
|
|
34
|
+
verbatim with the remaining args.
|
|
35
|
+
4. If the sub-command is unknown or missing, print the table above and ask:
|
|
36
|
+
|
|
37
|
+
> 1. add — write a curated entry interactively
|
|
38
|
+
> 2. load — load ALL entries of a type for deep analysis
|
|
39
|
+
> 3. promote — promote an intake signal to a curated entry
|
|
40
|
+
> 4. propose — drop a provisional signal into the intake stream
|
|
41
|
+
|
|
42
|
+
## Rules
|
|
43
|
+
|
|
44
|
+
- **Do NOT commit, push, or open a PR** unless the sub-command explicitly
|
|
45
|
+
authorizes it.
|
|
46
|
+
- **Do NOT chain sub-commands.** One `/memory <sub>` per turn.
|
|
47
|
+
- If the user invokes `/memory` with no argument, **show the menu** — do
|
|
48
|
+
not guess which sub-command they meant.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: module
|
|
2
|
+
name: module:create
|
|
3
|
+
cluster: module
|
|
4
|
+
sub: create
|
|
3
5
|
skills: [laravel]
|
|
4
6
|
description: Create a new module from .module-template with interactive setup
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "prompt mentions a new domain area without an existing module"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# module
|
|
13
|
-
|
|
14
|
+
# /module create
|
|
14
15
|
## Instructions
|
|
15
16
|
|
|
16
17
|
### 1. Check for module support
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: module
|
|
2
|
+
name: module:explore
|
|
3
|
+
cluster: module
|
|
4
|
+
sub: explore
|
|
3
5
|
skills: [laravel]
|
|
4
6
|
description: Explore a module — load its structure, docs, and context into the current conversation
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "existing Modules/<Name>/ referenced in the prompt"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# module
|
|
13
|
-
|
|
14
|
+
# /module explore
|
|
14
15
|
## Instructions
|
|
15
16
|
|
|
16
17
|
### 1. Check for modules
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: module
|
|
3
|
+
description: Module orchestrator — routes to create, explore
|
|
4
|
+
cluster: module
|
|
5
|
+
disable-model-invocation: true
|
|
6
|
+
suggestion:
|
|
7
|
+
eligible: true
|
|
8
|
+
trigger_description: "create a new module, explore an existing module"
|
|
9
|
+
trigger_context: "user wants to scaffold or load a module's docs and structure"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# /module
|
|
13
|
+
|
|
14
|
+
Top-level orchestrator for the `/module` family. Replaces 2 standalone
|
|
15
|
+
commands with a single entry point + sub-command dispatch.
|
|
16
|
+
|
|
17
|
+
## Sub-commands
|
|
18
|
+
|
|
19
|
+
| Sub-command | Routes to | Purpose |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| `/module create` | `commands/module/create.md` | Create a new module from `.module-template` |
|
|
22
|
+
| `/module explore` | `commands/module/explore.md` | Load a module's structure, docs, and context into the conversation |
|
|
23
|
+
|
|
24
|
+
Sub-command names match the locked contract in
|
|
25
|
+
[`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
26
|
+
|
|
27
|
+
## Dispatch
|
|
28
|
+
|
|
29
|
+
1. Parse the user's argument: `/module <sub-command> [args]`.
|
|
30
|
+
2. Look up the sub-command in the table above.
|
|
31
|
+
3. Load the body of the routed file and follow its `## Instructions` section
|
|
32
|
+
verbatim with the remaining args.
|
|
33
|
+
4. If the sub-command is unknown or missing, print the table above and ask:
|
|
34
|
+
|
|
35
|
+
> 1. create — scaffold a new module from the template
|
|
36
|
+
> 2. explore — load a module's docs and structure
|
|
37
|
+
|
|
38
|
+
## Rules
|
|
39
|
+
|
|
40
|
+
- **Do NOT commit, push, or open a PR** unless the sub-command explicitly
|
|
41
|
+
authorizes it.
|
|
42
|
+
- **Do NOT chain sub-commands.** One `/module <sub>` per turn.
|
|
43
|
+
- If the user invokes `/module` with no argument, **show the menu** — do
|
|
44
|
+
not guess which sub-command they meant.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: optimize
|
|
2
|
+
name: optimize:agents
|
|
3
|
+
cluster: optimize
|
|
4
|
+
sub: agents
|
|
3
5
|
description: Audits agent infrastructure — measures token overhead, checks rule triggers, verifies AGENTS.md. Suggest only, never auto-apply.
|
|
4
6
|
skills: [copilot-agents-optimization, agents-audit, agent-docs-writing, quality-tools]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "audit agent infrastructure, tune the agent setup"
|
|
9
11
|
trigger_context: "maintainer working on .augment/ files"
|
|
10
|
-
superseded_by: optimize agents
|
|
11
|
-
deprecated_in: "1.15.0"
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
> This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
16
|
-
|
|
17
|
-
# /optimize-agents
|
|
18
|
-
|
|
14
|
+
# /optimize agents
|
|
19
15
|
Agent infrastructure audit: measure token overhead, check rule triggers, verify AGENTS.md, find stale references. **Suggest only — never auto-apply.**
|
|
20
16
|
|
|
21
17
|
**Source of truth:** `.agent-src.uncompressed/` — never read or edit `.agent-src/` or `.augment/` directly.
|
|
@@ -1,22 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
skills: [agent-docs-writing]
|
|
3
|
-
name: optimize
|
|
3
|
+
name: optimize:augmentignore
|
|
4
|
+
cluster: optimize
|
|
5
|
+
sub: augmentignore
|
|
4
6
|
description: Creates or updates .augmentignore based on the project's actual tech stack, large files, generated artifacts, and irrelevant agent skills/rules.
|
|
5
7
|
disable-model-invocation: true
|
|
6
8
|
suggestion:
|
|
7
9
|
eligible: false
|
|
8
10
|
rationale: "Niche maintenance tool with no recurring NL trigger."
|
|
9
|
-
superseded_by: optimize augmentignore
|
|
10
|
-
deprecated_in: "1.15.0"
|
|
11
11
|
---
|
|
12
|
-
|
|
13
|
-
> ⚠️ /optimize-augmentignore is deprecated; use /optimize augmentignore instead.
|
|
14
|
-
> This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
15
|
-
|
|
16
12
|
<!-- cloud_safe: noop -->
|
|
17
13
|
|
|
18
|
-
# /optimize
|
|
19
|
-
|
|
14
|
+
# /optimize augmentignore
|
|
20
15
|
Scans the project to find files that waste tokens in Augment's retrieval index
|
|
21
16
|
and creates/updates `.augmentignore` accordingly. Also identifies irrelevant
|
|
22
17
|
`.augment/skills/` and `.augment/rules/` to exclude them from the system prompt.
|
|
@@ -1,20 +1,16 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: optimize
|
|
2
|
+
name: optimize:rtk
|
|
3
|
+
cluster: optimize
|
|
4
|
+
sub: rtk
|
|
3
5
|
skills: [agent-docs-writing]
|
|
4
6
|
description: Create or optimize project-local rtk filters based on the actual toolchain
|
|
5
7
|
disable-model-invocation: true
|
|
6
8
|
suggestion:
|
|
7
9
|
eligible: false
|
|
8
10
|
rationale: "Niche maintenance tool with no recurring NL trigger."
|
|
9
|
-
superseded_by: optimize rtk
|
|
10
|
-
deprecated_in: "1.15.0"
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
> This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
15
|
-
|
|
16
|
-
# optimize-rtk-filters
|
|
17
|
-
|
|
13
|
+
# /optimize rtk
|
|
18
14
|
## Instructions
|
|
19
15
|
|
|
20
16
|
### 1. Check rtk is installed
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: optimize
|
|
2
|
+
name: optimize:skills
|
|
3
|
+
cluster: optimize
|
|
4
|
+
sub: skills
|
|
3
5
|
description: Audits skills — measures baseline, finds duplicates/merge candidates, runs linter. Suggest only, never auto-apply.
|
|
4
6
|
skills: [skill-reviewer]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "audit my skills, find duplicate skills"
|
|
9
11
|
trigger_context: "maintainer working on .augment/skills/ files"
|
|
10
|
-
superseded_by: optimize skills
|
|
11
|
-
deprecated_in: "1.15.0"
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
> This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
16
|
-
|
|
17
|
-
# /optimize-skills
|
|
18
|
-
|
|
14
|
+
# /optimize skills
|
|
19
15
|
Skill audit: measure, find duplicates/merge candidates, run linter, present findings. **Suggest only — never auto-apply.**
|
|
20
16
|
|
|
21
17
|
**Source of truth:** `.agent-src.uncompressed/` — never read or edit `.agent-src/` or `.augment/` directly.
|
|
@@ -18,10 +18,10 @@ commands with a single entry point + sub-command dispatch.
|
|
|
18
18
|
|
|
19
19
|
| Sub-command | Routes to | Purpose |
|
|
20
20
|
|---|---|---|
|
|
21
|
-
| `/optimize skills` | `optimize
|
|
22
|
-
| `/optimize agents` | `optimize
|
|
23
|
-
| `/optimize augmentignore` | `optimize
|
|
24
|
-
| `/optimize rtk` | `optimize
|
|
21
|
+
| `/optimize skills` | `commands/optimize/skills.md` | Audit skills — measure baseline, find duplicates, run linter |
|
|
22
|
+
| `/optimize agents` | `commands/optimize/agents.md` | Audit agent infrastructure — token overhead, rule triggers, AGENTS.md |
|
|
23
|
+
| `/optimize augmentignore` | `commands/optimize/augmentignore.md` | Create or refine `.augmentignore` based on actual stack |
|
|
24
|
+
| `/optimize rtk` | `commands/optimize/rtk.md` | Create or refine project-local rtk filters |
|
|
25
25
|
|
|
26
26
|
Sub-command names match the locked contract in
|
|
27
27
|
[`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
@@ -39,12 +39,6 @@ Sub-command names match the locked contract in
|
|
|
39
39
|
> 3. augmentignore — create or refine `.augmentignore`
|
|
40
40
|
> 4. rtk — create or refine project-local rtk filters
|
|
41
41
|
|
|
42
|
-
## Migration
|
|
43
|
-
|
|
44
|
-
The 4 standalone `/optimize-*` commands continue to work for one release
|
|
45
|
-
cycle as deprecation shims. They emit a notice and route to the same
|
|
46
|
-
content. New invocations should use `/optimize <sub>`.
|
|
47
|
-
|
|
48
42
|
## Rules
|
|
49
43
|
|
|
50
44
|
- **Suggest only — never auto-apply.** All `/optimize` sub-commands are
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: override
|
|
2
|
+
name: override:create
|
|
3
|
+
cluster: override
|
|
4
|
+
sub: create
|
|
3
5
|
description: Creates a project-level override for a shared skill, rule, or command.
|
|
4
6
|
skills: [override-management, agent-docs-writing]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "prompt names a shared skill/rule needing project-specific behavior"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# /override
|
|
13
|
-
|
|
14
|
+
# /override create
|
|
14
15
|
Creates an override file in `agents/overrides/` for a shared `.augment/` resource.
|
|
15
16
|
|
|
16
17
|
## Steps
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: override
|
|
2
|
+
name: override:manage
|
|
3
|
+
cluster: override
|
|
4
|
+
sub: manage
|
|
3
5
|
description: Reviews, updates, and refactors existing project-level overrides.
|
|
4
6
|
skills: [override-management, agent-docs-writing]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "existing entries under agents/overrides/"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# /override
|
|
13
|
-
|
|
14
|
+
# /override manage
|
|
14
15
|
Manages existing overrides in `agents/overrides/`.
|
|
15
16
|
|
|
16
17
|
## Steps
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: override
|
|
3
|
+
description: Override orchestrator — routes to create, manage
|
|
4
|
+
cluster: override
|
|
5
|
+
disable-model-invocation: true
|
|
6
|
+
suggestion:
|
|
7
|
+
eligible: true
|
|
8
|
+
trigger_description: "create an override, manage existing overrides, refactor an override"
|
|
9
|
+
trigger_context: "user wants to add or curate project-level overrides under agents/overrides/"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# /override
|
|
13
|
+
|
|
14
|
+
Top-level orchestrator for the `/override` family. Replaces 2 standalone
|
|
15
|
+
commands with a single entry point + sub-command dispatch.
|
|
16
|
+
|
|
17
|
+
## Sub-commands
|
|
18
|
+
|
|
19
|
+
| Sub-command | Routes to | Purpose |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| `/override create` | `commands/override/create.md` | Create a project-level override for a shared skill, rule, or command |
|
|
22
|
+
| `/override manage` | `commands/override/manage.md` | Review, update, and refactor existing overrides |
|
|
23
|
+
|
|
24
|
+
Sub-command names match the locked contract in
|
|
25
|
+
[`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
26
|
+
|
|
27
|
+
## Dispatch
|
|
28
|
+
|
|
29
|
+
1. Parse the user's argument: `/override <sub-command> [args]`.
|
|
30
|
+
2. Look up the sub-command in the table above.
|
|
31
|
+
3. Load the body of the routed file and follow its `## Instructions` section
|
|
32
|
+
verbatim with the remaining args.
|
|
33
|
+
4. If the sub-command is unknown or missing, print the table above and ask:
|
|
34
|
+
|
|
35
|
+
> 1. create — author a new project-level override
|
|
36
|
+
> 2. manage — review, update, refactor existing overrides
|
|
37
|
+
|
|
38
|
+
## Rules
|
|
39
|
+
|
|
40
|
+
- **Do NOT commit, push, or open a PR** unless the sub-command explicitly
|
|
41
|
+
authorizes it.
|
|
42
|
+
- **Do NOT chain sub-commands.** One `/override <sub>` per turn.
|
|
43
|
+
- If the user invokes `/override` with no argument, **show the menu** — do
|
|
44
|
+
not guess which sub-command they meant.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: roadmap
|
|
2
|
+
name: roadmap:create
|
|
3
|
+
cluster: roadmap
|
|
4
|
+
sub: create
|
|
3
5
|
skills: [agent-docs-writing]
|
|
4
6
|
description: Interactively create a new roadmap file in agents/roadmaps/
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "multi-phase work without an existing agents/roadmaps/*.md"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# roadmap
|
|
13
|
-
|
|
14
|
+
# /roadmap create
|
|
14
15
|
## Instructions
|
|
15
16
|
|
|
16
17
|
### 1. Determine location
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: roadmap
|
|
2
|
+
name: roadmap:execute
|
|
3
|
+
cluster: roadmap
|
|
4
|
+
sub: execute
|
|
3
5
|
skills: [agent-docs-writing]
|
|
4
6
|
description: Read and interactively execute a roadmap from agents/roadmaps/
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "existing agents/roadmaps/*.md referenced in the prompt"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# roadmap
|
|
13
|
-
|
|
14
|
+
# /roadmap execute
|
|
14
15
|
## Instructions
|
|
15
16
|
|
|
16
17
|
### 1. Find the roadmap
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: roadmap
|
|
3
|
+
description: Roadmap orchestrator — routes to create, execute
|
|
4
|
+
cluster: roadmap
|
|
5
|
+
disable-model-invocation: true
|
|
6
|
+
suggestion:
|
|
7
|
+
eligible: true
|
|
8
|
+
trigger_description: "create a roadmap, execute a roadmap, plan a roadmap interactively"
|
|
9
|
+
trigger_context: "user wants to scaffold or run a roadmap under agents/roadmaps/"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# /roadmap
|
|
13
|
+
|
|
14
|
+
Top-level orchestrator for the `/roadmap` family. Replaces 2 standalone
|
|
15
|
+
commands with a single entry point + sub-command dispatch.
|
|
16
|
+
|
|
17
|
+
## Sub-commands
|
|
18
|
+
|
|
19
|
+
| Sub-command | Routes to | Purpose |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| `/roadmap create` | `commands/roadmap/create.md` | Interactively create a new roadmap in `agents/roadmaps/` |
|
|
22
|
+
| `/roadmap execute` | `commands/roadmap/execute.md` | Read and interactively execute a roadmap |
|
|
23
|
+
|
|
24
|
+
Sub-command names match the locked contract in
|
|
25
|
+
[`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
26
|
+
|
|
27
|
+
## Dispatch
|
|
28
|
+
|
|
29
|
+
1. Parse the user's argument: `/roadmap <sub-command> [args]`.
|
|
30
|
+
2. Look up the sub-command in the table above.
|
|
31
|
+
3. Load the body of the routed file and follow its `## Instructions` section
|
|
32
|
+
verbatim with the remaining args.
|
|
33
|
+
4. If the sub-command is unknown or missing, print the table above and ask:
|
|
34
|
+
|
|
35
|
+
> 1. create — scaffold a new roadmap interactively
|
|
36
|
+
> 2. execute — run an existing roadmap step by step
|
|
37
|
+
|
|
38
|
+
## Rules
|
|
39
|
+
|
|
40
|
+
- **Do NOT commit, push, or open a PR** unless the sub-command explicitly
|
|
41
|
+
authorizes it.
|
|
42
|
+
- **Do NOT chain sub-commands.** One `/roadmap <sub>` per turn.
|
|
43
|
+
- If the user invokes `/roadmap` with no argument, **show the menu** — do
|
|
44
|
+
not guess which sub-command they meant.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: tests
|
|
2
|
+
name: tests:create
|
|
3
|
+
cluster: tests
|
|
4
|
+
sub: create
|
|
3
5
|
skills: [pest-testing]
|
|
4
6
|
description: Write meaningful tests for the changes in the current branch
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,8 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "code changes on the branch without matching test changes"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# tests
|
|
13
|
-
|
|
14
|
+
# /tests create
|
|
14
15
|
## Instructions
|
|
15
16
|
|
|
16
17
|
### 1. Detect the test framework
|