@event4u/agent-config 1.16.0 → 1.17.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/direct-answers.md +34 -49
- 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 +45 -52
- package/.agent-src/rules/no-roadmap-references.md +73 -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 +10 -71
- 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/.claude-plugin/marketplace.json +22 -11
- package/AGENTS.md +2 -2
- package/CHANGELOG.md +90 -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 +178 -0
- package/docs/contracts/load-context-schema.md +1 -3
- 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/asking-and-brevity-examples.md +100 -0
- package/package.json +1 -1
- package/scripts/_one_off_phase4_dispatch_latency.py +108 -0
- package/scripts/_one_off_phase6_trigger_jaccard.py +92 -0
- package/scripts/_phase2_shim_helper.py +109 -0
- package/scripts/agent-config +10 -0
- package/scripts/ai_council/_one_off_2a4_acceptance.py +208 -0
- package/scripts/ai_council/_one_off_context_layer_v1_estimate.py +67 -0
- package/scripts/ai_council/_one_off_context_layer_v1_review.py +292 -0
- package/scripts/ai_council/_one_off_followups_review.py +259 -0
- package/scripts/ai_council/_one_off_nondestructive_inline_audit.py +209 -0
- package/scripts/ai_council/_one_off_phase_2a_budget_rebalance.py +257 -0
- package/scripts/ai_council/_one_off_phase_2a_post_revert.py +197 -0
- package/scripts/ai_council/_one_off_rule_hardening_v1.py +251 -0
- package/scripts/ai_council/_one_off_structural_open_questions.py +232 -0
- package/scripts/ai_council/_one_off_structural_optimization.py +144 -0
- package/scripts/ai_council/_one_off_structural_v3_gaps.py +252 -0
- package/scripts/ai_council/_one_off_structural_v3_review.py +240 -0
- package/scripts/check_always_budget.py +363 -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_phase_coupling.py +148 -0
- package/scripts/check_portability.py +2 -0
- package/scripts/check_references.py +29 -2
- package/scripts/check_safety_floor_untouched.py +125 -0
- package/scripts/command_suggester/loader.py +4 -1
- package/scripts/compress.py +59 -13
- package/scripts/generate_index.py +6 -2
- package/scripts/generate_ownership_matrix.py +323 -0
- package/scripts/hooks/augment-roadmap-progress.sh +57 -0
- package/scripts/install.py +49 -28
- package/scripts/lint_no_new_atomic_commands.py +12 -11
- 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/skill_linter.py +1 -0
- package/scripts/sync_agent_settings.py +25 -2
- package/scripts/update_counts.py +7 -0
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: create-pr-
|
|
2
|
+
name: create-pr:description-only
|
|
3
|
+
cluster: create-pr
|
|
4
|
+
sub: description-only
|
|
3
5
|
skills: [git-workflow]
|
|
4
6
|
description: Generate a PR description as a copyable markdown block — used standalone or by create-pr
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,7 +11,7 @@ suggestion:
|
|
|
9
11
|
trigger_context: "PR exists or branch ready for review without description"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
# create-pr-
|
|
14
|
+
# /create-pr:description-only
|
|
13
15
|
|
|
14
16
|
## Input
|
|
15
17
|
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: create-pr
|
|
3
|
+
cluster: create-pr
|
|
3
4
|
skills: [git-workflow]
|
|
4
5
|
description: Create a GitHub PR with structured description from Jira ticket and code changes
|
|
5
6
|
disable-model-invocation: true
|
|
@@ -9,11 +10,31 @@ suggestion:
|
|
|
9
10
|
trigger_context: "branch is ahead of base and not yet on a PR"
|
|
10
11
|
---
|
|
11
12
|
|
|
12
|
-
# create-pr
|
|
13
|
+
# /create-pr
|
|
13
14
|
|
|
14
|
-
|
|
15
|
+
Top-level entry point for the `/create-pr` family. Bare `/create-pr`
|
|
16
|
+
runs the full create-PR flow described below. The `:description-only`
|
|
17
|
+
sub-command produces a copyable PR description without creating the PR.
|
|
15
18
|
|
|
16
|
-
##
|
|
19
|
+
## Sub-commands
|
|
20
|
+
|
|
21
|
+
| Sub-command | Routes to | Purpose |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| `/create-pr` (bare) | this file (`## Default flow`) | Full flow — generate description, push, create PR |
|
|
24
|
+
| `/create-pr:description-only` | `commands/create-pr/description-only.md` | Generate the PR description as a copyable markdown block, no PR creation |
|
|
25
|
+
|
|
26
|
+
## Dispatch
|
|
27
|
+
|
|
28
|
+
1. Parse the user's argument: `/create-pr[:<sub>] [args]`.
|
|
29
|
+
2. Bare `/create-pr` → run the `## Default flow` below verbatim.
|
|
30
|
+
3. `/create-pr:description-only` → load
|
|
31
|
+
`commands/create-pr/description-only.md` and follow its
|
|
32
|
+
`## Instructions` section verbatim.
|
|
33
|
+
4. Unknown sub-command → print the table above and ask which one.
|
|
34
|
+
|
|
35
|
+
## Default flow
|
|
36
|
+
|
|
37
|
+
Uses `/create-pr:description-only` to generate the PR content, then creates the PR via GitHub API.
|
|
17
38
|
|
|
18
39
|
### 1. Check prerequisites
|
|
19
40
|
|
|
@@ -24,12 +45,12 @@ Uses `/create-pr-description` to generate the PR content, then creates the PR vi
|
|
|
24
45
|
|
|
25
46
|
### 2. Generate PR content
|
|
26
47
|
|
|
27
|
-
Run `/create-pr-
|
|
48
|
+
Run `/create-pr:description-only` to generate the PR title and body.
|
|
28
49
|
This handles: Jira ticket extraction, diff analysis, commit messages, **PR template filling**.
|
|
29
50
|
|
|
30
51
|
**CRITICAL**: The PR body MUST use the project's PR template (`.github/pull_request_template.md`).
|
|
31
52
|
Read the template file and fill in its sections. If the template does not exist, use the
|
|
32
|
-
fallback structure defined in `/create-pr-
|
|
53
|
+
fallback structure defined in `/create-pr:description-only`. NEVER invent a custom body structure.
|
|
33
54
|
|
|
34
55
|
The user reviews and adjusts the content in that step.
|
|
35
56
|
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: feature
|
|
2
|
+
name: feature:dev
|
|
3
|
+
cluster: feature
|
|
4
|
+
sub: dev
|
|
3
5
|
description: Full 7-phase feature development workflow for complex features.
|
|
4
6
|
skills: [laravel, php-coder]
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -9,20 +11,13 @@ suggestion:
|
|
|
9
11
|
trigger_context: "long-form feature description spanning multiple components"
|
|
10
12
|
---
|
|
11
13
|
|
|
12
|
-
|
|
13
|
-
> **Deprecated — use `/feature dev`.** This standalone command
|
|
14
|
-
> is kept as a deprecation shim for one release cycle and routes to
|
|
15
|
-
> the same instructions below. New invocations should go through the
|
|
16
|
-
> `/feature` orchestrator (`commands/feature.md`).
|
|
17
|
-
<!-- /F2-deprecation-banner -->
|
|
18
|
-
|
|
19
|
-
# /feature-dev
|
|
14
|
+
# /feature:dev
|
|
20
15
|
|
|
21
16
|
> Full 7-phase feature development workflow for complex features.
|
|
22
17
|
|
|
23
18
|
## Trigger
|
|
24
19
|
|
|
25
|
-
`/feature
|
|
20
|
+
`/feature:dev {description}` or `/feature:dev` (interactive)
|
|
26
21
|
|
|
27
22
|
## When to use
|
|
28
23
|
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: feature
|
|
2
|
+
name: feature:explore
|
|
3
|
+
cluster: feature
|
|
4
|
+
sub: explore
|
|
3
5
|
skills: [laravel]
|
|
4
6
|
description: Brainstorm and explore a feature idea before committing to a full plan
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "brainstorm this idea, explore this feature concept"
|
|
9
11
|
trigger_context: "open-ended feature idea without acceptance criteria"
|
|
10
|
-
superseded_by: feature explore
|
|
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
|
-
# feature-explore
|
|
18
|
-
|
|
14
|
+
# /feature explore
|
|
19
15
|
## Instructions
|
|
20
16
|
|
|
21
17
|
This is a **lightweight, conversational** exploration — no structured output yet.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: feature
|
|
2
|
+
name: feature:plan
|
|
3
|
+
cluster: feature
|
|
4
|
+
sub: plan
|
|
3
5
|
skills: [feature-planning]
|
|
4
6
|
description: Interactively plan a feature — research, discuss, and create a structured feature document
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "plan this feature, create a feature spec for X"
|
|
9
11
|
trigger_context: "feature idea referenced and no plan doc exists"
|
|
10
|
-
superseded_by: feature plan
|
|
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
|
-
# feature-plan
|
|
18
|
-
|
|
14
|
+
# /feature plan
|
|
19
15
|
## Instructions
|
|
20
16
|
|
|
21
17
|
### 1. Gather the idea
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: feature
|
|
2
|
+
name: feature:refactor
|
|
3
|
+
cluster: feature
|
|
4
|
+
sub: refactor
|
|
3
5
|
skills: [laravel, php-coder]
|
|
4
6
|
description: Refine and update an existing feature plan through interactive discussion
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "update the feature plan, refine the feature spec"
|
|
9
11
|
trigger_context: "existing agents/features/*.md referenced in the prompt"
|
|
10
|
-
superseded_by: feature refactor
|
|
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
|
-
# feature-refactor
|
|
18
|
-
|
|
14
|
+
# /feature refactor
|
|
19
15
|
## Instructions
|
|
20
16
|
|
|
21
17
|
### 1. Find the feature
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: feature
|
|
2
|
+
name: feature:roadmap
|
|
3
|
+
cluster: feature
|
|
4
|
+
sub: roadmap
|
|
3
5
|
skills: [agent-docs-writing]
|
|
4
6
|
description: Generate implementation roadmap(s) from a feature plan and link them
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "turn this feature into a roadmap, generate the implementation roadmap"
|
|
9
11
|
trigger_context: "existing feature plan without linked roadmap"
|
|
10
|
-
superseded_by: feature roadmap
|
|
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
|
-
# feature-roadmap
|
|
18
|
-
|
|
14
|
+
# /feature roadmap
|
|
19
15
|
## Instructions
|
|
20
16
|
|
|
21
17
|
### 1. Find the feature
|
|
@@ -47,7 +43,7 @@ Stop.
|
|
|
47
43
|
### 2. Analyze the feature
|
|
48
44
|
|
|
49
45
|
- Read the feature file completely.
|
|
50
|
-
- Read
|
|
46
|
+
- Read the roadmap template at `.augment/templates/roadmaps.md` for the structure.
|
|
51
47
|
- Research the codebase for affected areas mentioned in the feature.
|
|
52
48
|
|
|
53
49
|
Determine how many roadmaps are needed:
|
|
@@ -185,7 +181,7 @@ What's next?
|
|
|
185
181
|
requested them. See [`commit-policy`](../rules/commit-policy.md#never-write-commit-steps-into-roadmaps-unsolicited).
|
|
186
182
|
- **Do NOT modify the feature plan** beyond updating the Roadmaps section and status.
|
|
187
183
|
- **Always link roadmaps back to the feature** and vice versa.
|
|
188
|
-
- **Use the roadmap template**
|
|
184
|
+
- **Use the roadmap template** at `.augment/templates/roadmaps.md`.
|
|
189
185
|
- **Reference specific files** in roadmap tasks — not vague descriptions.
|
|
190
186
|
- **Include quality gates** (PHPStan, Rector, tests) in every phase.
|
|
191
187
|
- **Research the codebase** to make tasks concrete and realistic.
|
|
@@ -18,11 +18,11 @@ commands with a single entry point + sub-command dispatch.
|
|
|
18
18
|
|
|
19
19
|
| Sub-command | Routes to | Purpose |
|
|
20
20
|
|---|---|---|
|
|
21
|
-
| `/feature explore` | `feature
|
|
22
|
-
| `/feature plan` | `feature
|
|
23
|
-
| `/feature refactor` | `feature
|
|
24
|
-
| `/feature roadmap` | `feature
|
|
25
|
-
| `/feature dev` | `feature
|
|
21
|
+
| `/feature explore` | `commands/feature/explore.md` | Brainstorm an idea before committing to a plan |
|
|
22
|
+
| `/feature plan` | `commands/feature/plan.md` | Interactively plan a feature, produce a structured plan doc |
|
|
23
|
+
| `/feature refactor` | `commands/feature/refactor.md` | Refine and update an existing feature plan |
|
|
24
|
+
| `/feature roadmap` | `commands/feature/roadmap.md` | Generate implementation roadmap(s) from a plan |
|
|
25
|
+
| `/feature dev` | `commands/feature/dev.md` | Full 7-phase feature development workflow (heavyweight) |
|
|
26
26
|
|
|
27
27
|
## Workflow ordering
|
|
28
28
|
|
|
@@ -33,7 +33,7 @@ implementation). Use `refactor` whenever an existing plan needs an update.
|
|
|
33
33
|
|
|
34
34
|
1. Parse the user's argument: `/feature <sub-command> [args]`.
|
|
35
35
|
2. Look up the sub-command in the table above.
|
|
36
|
-
3. Load the body of the corresponding `commands/feature
|
|
36
|
+
3. Load the body of the corresponding `commands/feature/<sub>.md` file and
|
|
37
37
|
follow its `## Instructions` (or `## Steps`) section verbatim.
|
|
38
38
|
4. If the sub-command is unknown or missing, print the menu and ask:
|
|
39
39
|
|
|
@@ -43,12 +43,6 @@ implementation). Use `refactor` whenever an existing plan needs an update.
|
|
|
43
43
|
> 4. roadmap — generate roadmap(s) from a plan
|
|
44
44
|
> 5. dev — run the full 7-phase development workflow
|
|
45
45
|
|
|
46
|
-
## Migration
|
|
47
|
-
|
|
48
|
-
The 5 standalone `/feature-*` commands continue to work for one release
|
|
49
|
-
cycle as deprecation shims. They emit a notice and route to the same
|
|
50
|
-
content. New invocations should use `/feature <sub>`.
|
|
51
|
-
|
|
52
46
|
## Rules
|
|
53
47
|
|
|
54
48
|
- **Do NOT chain sub-commands.** One `/feature <sub>` per turn — except
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fix
|
|
2
|
+
name: fix:ci
|
|
3
|
+
cluster: fix
|
|
4
|
+
sub: ci
|
|
3
5
|
skills: [github-ci, quality-tools]
|
|
4
6
|
description: Fetch CI errors from GitHub Actions and fix them
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "CI is failing, fix the GitHub Actions errors, the pipeline is red"
|
|
9
11
|
trigger_context: "open PR with failing checks"
|
|
10
|
-
superseded_by: fix ci
|
|
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
|
-
# fix-ci
|
|
18
|
-
|
|
14
|
+
# /fix ci
|
|
19
15
|
## Instructions
|
|
20
16
|
|
|
21
17
|
### 1. Identify the failing CI run
|
|
@@ -1,19 +1,15 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fix
|
|
2
|
+
name: fix:portability
|
|
3
|
+
cluster: fix
|
|
4
|
+
sub: portability
|
|
3
5
|
description: Find and fix project-specific references in shared .augment/ package files
|
|
4
6
|
disable-model-invocation: true
|
|
5
7
|
suggestion:
|
|
6
8
|
eligible: false
|
|
7
9
|
rationale: "Package-internal — only the event4u/agent-config repo runs this."
|
|
8
|
-
superseded_by: fix portability
|
|
9
|
-
deprecated_in: "1.15.0"
|
|
10
10
|
---
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
> 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).
|
|
14
|
-
|
|
15
|
-
# fix-portability
|
|
16
|
-
|
|
12
|
+
# /fix portability
|
|
17
13
|
## Instructions
|
|
18
14
|
|
|
19
15
|
### 1. Run the portability checker
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fix
|
|
2
|
+
name: fix:pr-bots
|
|
3
|
+
cluster: fix
|
|
4
|
+
sub: pr-bots
|
|
3
5
|
skills: [php-coder, quality-tools]
|
|
4
6
|
description: Fix and reply to bot review comments (Copilot, Augment, Greptile, etc.) on a GitHub PR
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "address the Copilot/Greptile comments, fix the bot review feedback"
|
|
9
11
|
trigger_context: "open PR with bot review comments unresolved"
|
|
10
|
-
superseded_by: fix pr-bots
|
|
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
|
-
# fix-pr-bot-comments
|
|
18
|
-
|
|
14
|
+
# /fix pr-bots
|
|
19
15
|
## Input
|
|
20
16
|
|
|
21
17
|
The user may or may not provide a PR URL.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fix
|
|
2
|
+
name: fix:pr-developers
|
|
3
|
+
cluster: fix
|
|
4
|
+
sub: pr-developers
|
|
3
5
|
skills: [php-coder]
|
|
4
6
|
description: Fix and reply to human reviewer comments on a GitHub PR
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "fix the human reviewer comments, address the developer feedback"
|
|
9
11
|
trigger_context: "open PR with unresolved human-reviewer comments"
|
|
10
|
-
superseded_by: fix pr-developers
|
|
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
|
-
# fix-pr-developer-comments
|
|
18
|
-
|
|
14
|
+
# /fix pr-developers
|
|
19
15
|
## Input
|
|
20
16
|
|
|
21
17
|
The user may or may not provide a PR URL.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fix
|
|
2
|
+
name: fix:pr
|
|
3
|
+
cluster: fix
|
|
4
|
+
sub: pr
|
|
3
5
|
skills: [php-coder]
|
|
4
6
|
description: Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,16 +9,10 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "fix all PR review comments, resolve the review feedback"
|
|
9
11
|
trigger_context: "open PR with unresolved comments (bot + human)"
|
|
10
|
-
superseded_by: fix pr
|
|
11
|
-
deprecated_in: "1.15.0"
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
# fix-pr-comments
|
|
18
|
-
|
|
19
|
-
This command runs `fix-pr-bot-comments` and `fix-pr-developer-comments` in sequence on the same PR.
|
|
14
|
+
# /fix pr
|
|
15
|
+
This command runs `/fix pr-bots` and `/fix pr-developers` in sequence on the same PR.
|
|
20
16
|
|
|
21
17
|
## Input
|
|
22
18
|
|
|
@@ -49,14 +45,14 @@ The chosen mode applies to **both** phases.
|
|
|
49
45
|
|
|
50
46
|
### Phase 1: Bot comments
|
|
51
47
|
|
|
52
|
-
Follow the full
|
|
48
|
+
Follow the full `/fix pr-bots` instructions (see `commands/fix/pr-bots.md`).
|
|
53
49
|
Use the already-confirmed PR and mode — do not ask again.
|
|
54
50
|
|
|
55
51
|
Report when done: "Bot comments done. Continuing with reviewer comments..."
|
|
56
52
|
|
|
57
53
|
### Phase 2: Developer comments
|
|
58
54
|
|
|
59
|
-
Follow the full
|
|
55
|
+
Follow the full `/fix pr-developers` instructions (see `commands/fix/pr-developers.md`).
|
|
60
56
|
Use the same PR and mode.
|
|
61
57
|
|
|
62
58
|
### After both phases
|
|
@@ -1,19 +1,15 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fix
|
|
2
|
+
name: fix:refs
|
|
3
|
+
cluster: fix
|
|
4
|
+
sub: refs
|
|
3
5
|
description: Find and fix broken cross-references in .augment/ and agents/ files
|
|
4
6
|
disable-model-invocation: true
|
|
5
7
|
suggestion:
|
|
6
8
|
eligible: false
|
|
7
9
|
rationale: "Package-internal — only the event4u/agent-config repo runs this."
|
|
8
|
-
superseded_by: fix refs
|
|
9
|
-
deprecated_in: "1.15.0"
|
|
10
10
|
---
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
> 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).
|
|
14
|
-
|
|
15
|
-
# fix-references
|
|
16
|
-
|
|
12
|
+
# /fix refs
|
|
17
13
|
## Instructions
|
|
18
14
|
|
|
19
15
|
### 1. Run the reference checker
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fix
|
|
2
|
+
name: fix:seeder
|
|
3
|
+
cluster: fix
|
|
4
|
+
sub: seeder
|
|
3
5
|
skills: [eloquent]
|
|
4
6
|
description: Scan seeder data files for broken foreign key references — find constants used without getReference() and fix them
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -7,15 +9,9 @@ suggestion:
|
|
|
7
9
|
eligible: true
|
|
8
10
|
trigger_description: "the seeder is broken, foreign key errors in seeders"
|
|
9
11
|
trigger_context: "seeder error output or recent edits in database/seeders/"
|
|
10
|
-
superseded_by: fix seeder
|
|
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
|
-
# fix-seeder
|
|
18
|
-
|
|
14
|
+
# /fix seeder
|
|
19
15
|
Scans all `PhpDataSeeder` data files for foreign key references that use raw seeder constants
|
|
20
16
|
instead of `getReference()`. Raw constants don't trigger lazy initialization of the referenced
|
|
21
17
|
seeder, causing "items not available" errors when seeders run in unpredictable order.
|
|
@@ -18,13 +18,13 @@ with a single entry point + sub-command dispatch.
|
|
|
18
18
|
|
|
19
19
|
| Sub-command | Routes to | Purpose |
|
|
20
20
|
|---|---|---|
|
|
21
|
-
| `/fix ci` | `fix
|
|
22
|
-
| `/fix refs` | `fix
|
|
23
|
-
| `/fix portability` | `fix
|
|
24
|
-
| `/fix seeder` | `fix
|
|
25
|
-
| `/fix pr` | `fix
|
|
26
|
-
| `/fix pr-bots` | `fix
|
|
27
|
-
| `/fix pr-developers` | `fix
|
|
21
|
+
| `/fix ci` | `commands/fix/ci.md` | Fetch CI errors from GitHub Actions and fix them |
|
|
22
|
+
| `/fix refs` | `commands/fix/refs.md` | Find and fix broken cross-references in `.augment/` and `agents/` |
|
|
23
|
+
| `/fix portability` | `commands/fix/portability.md` | Find and fix project-specific references in shared `.augment/` files |
|
|
24
|
+
| `/fix seeder` | `commands/fix/seeder.md` | Scan seeder data files for broken FK references |
|
|
25
|
+
| `/fix pr` | `commands/fix/pr.md` | Fix and reply to **all** open review comments (bots + humans) |
|
|
26
|
+
| `/fix pr-bots` | `commands/fix/pr-bots.md` | Fix and reply to **bot** review comments only |
|
|
27
|
+
| `/fix pr-developers` | `commands/fix/pr-developers.md` | Fix and reply to **human** reviewer comments only |
|
|
28
28
|
|
|
29
29
|
Sub-command names match the locked contract in
|
|
30
30
|
[`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
|
|
@@ -45,12 +45,6 @@ Sub-command names match the locked contract in
|
|
|
45
45
|
> 6. pr-bots — address bot reviewer comments only
|
|
46
46
|
> 7. pr-developers — address human reviewer comments only
|
|
47
47
|
|
|
48
|
-
## Migration
|
|
49
|
-
|
|
50
|
-
The 7 standalone `/fix-*` commands continue to work for one release cycle as
|
|
51
|
-
deprecation shims. They emit a notice and route to the same content. New
|
|
52
|
-
invocations should use `/fix <sub>`.
|
|
53
|
-
|
|
54
48
|
## Rules
|
|
55
49
|
|
|
56
50
|
- **Do NOT commit, push, or open a PR** unless the sub-command explicitly
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: judge:on-diff
|
|
3
|
+
cluster: judge
|
|
4
|
+
sub: on-diff
|
|
3
5
|
skills: [subagent-orchestration, verify-completion-evidence]
|
|
4
6
|
description: Run a single change through an implementer→judge loop with a two-revision ceiling, then hand back to the user
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -8,8 +10,7 @@ suggestion:
|
|
|
8
10
|
rationale: "Subagent orchestration — overlaps /work and judge skills; keep explicit."
|
|
9
11
|
---
|
|
10
12
|
|
|
11
|
-
#
|
|
12
|
-
|
|
13
|
+
# /judge on-diff
|
|
13
14
|
## Instructions
|
|
14
15
|
|
|
15
16
|
### 1. Confirm scope
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: judge:solo
|
|
3
|
+
cluster: judge
|
|
4
|
+
sub: solo
|
|
5
|
+
skills: [subagent-orchestration]
|
|
6
|
+
description: Run a standalone judge on an existing diff or code change — no implementer, no revision loop, verdict only
|
|
7
|
+
disable-model-invocation: true
|
|
8
|
+
suggestion:
|
|
9
|
+
eligible: false
|
|
10
|
+
rationale: "Sibling of /review-changes — eligibility routed there; keep this explicit."
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# /judge solo
|
|
14
|
+
## Instructions
|
|
15
|
+
|
|
16
|
+
### 1. Identify the target
|
|
17
|
+
|
|
18
|
+
The user invoked `/judge solo` on one of:
|
|
19
|
+
|
|
20
|
+
- The current working-tree diff (`git diff`)
|
|
21
|
+
- A specific commit range (`git diff A..B`)
|
|
22
|
+
- A PR by number or URL
|
|
23
|
+
- A single file or set of files
|
|
24
|
+
|
|
25
|
+
Confirm the target in one sentence before proceeding. Do not silently
|
|
26
|
+
assume the working tree.
|
|
27
|
+
|
|
28
|
+
### 2. Gather the context
|
|
29
|
+
|
|
30
|
+
Collect what the judge needs:
|
|
31
|
+
|
|
32
|
+
- The diff in full
|
|
33
|
+
- The original task, ticket, or PR description
|
|
34
|
+
- Relevant acceptance criteria (tests, linter config, design doc)
|
|
35
|
+
|
|
36
|
+
If any of these is missing and the judgment would be shallow without
|
|
37
|
+
it, **stop** and ask.
|
|
38
|
+
|
|
39
|
+
### 3. Resolve the judge model
|
|
40
|
+
|
|
41
|
+
Read `.agent-settings.yml`:
|
|
42
|
+
|
|
43
|
+
- `subagents.judge_model` → empty = one tier above session model
|
|
44
|
+
|
|
45
|
+
Unknown alias → stop. Silence is not a fallback.
|
|
46
|
+
|
|
47
|
+
### 4. Invoke the judge
|
|
48
|
+
|
|
49
|
+
The judge reviews the diff against the task. Return one of:
|
|
50
|
+
|
|
51
|
+
| Verdict | Meaning |
|
|
52
|
+
|----------|----------------------------------------------|
|
|
53
|
+
| `apply` | Correct, complete, ready to land |
|
|
54
|
+
| `revise` | Specific issues listed — user decides next |
|
|
55
|
+
| `reject` | Fundamentally wrong approach |
|
|
56
|
+
|
|
57
|
+
Unlike `/judge on-diff`, this command does **not** loop — no revision
|
|
58
|
+
cycles. The verdict is the deliverable.
|
|
59
|
+
|
|
60
|
+
### 5. Report
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
Mode: judge (standalone)
|
|
64
|
+
Target: <diff | commit range | PR #N | files>
|
|
65
|
+
Judge: <resolved model>
|
|
66
|
+
Verdict: apply | revise | reject
|
|
67
|
+
Issues: <numbered list if revise/reject>
|
|
68
|
+
Next step: <what the user should do based on the verdict>
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Use this command when
|
|
72
|
+
|
|
73
|
+
- A diff already exists and the user wants a second opinion
|
|
74
|
+
- Reviewing someone else's PR before approving it
|
|
75
|
+
- Double-checking a change before opening a PR
|
|
76
|
+
- Stress-testing a refactor without committing to revisions
|
|
77
|
+
|
|
78
|
+
## Do NOT
|
|
79
|
+
|
|
80
|
+
- NEVER apply the diff — this command judges only
|
|
81
|
+
- NEVER loop into a revision cycle — use `/judge on-diff` for that
|
|
82
|
+
- NEVER run the judge on an empty diff — fail fast
|
|
83
|
+
- NEVER silently fall back to the session model for the judge
|
|
84
|
+
|
|
85
|
+
## See also
|
|
86
|
+
|
|
87
|
+
- [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md)
|
|
88
|
+
- [`/judge on-diff`](do-and-judge.md) — if a revision loop is wanted
|
|
89
|
+
- [`/review-changes`](review-changes.md) — human-oriented self-review
|
|
90
|
+
- [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: judge:steps
|
|
3
|
+
cluster: judge
|
|
4
|
+
sub: steps
|
|
3
5
|
skills: [subagent-orchestration, verify-completion-evidence]
|
|
4
6
|
description: Execute an ordered plan step by step with a judge gate between steps — stops on first failed verdict
|
|
5
7
|
disable-model-invocation: true
|
|
@@ -8,8 +10,7 @@ suggestion:
|
|
|
8
10
|
rationale: "Subagent orchestration — overlaps /work and /roadmap-execute; keep explicit."
|
|
9
11
|
---
|
|
10
12
|
|
|
11
|
-
#
|
|
12
|
-
|
|
13
|
+
# /judge steps
|
|
13
14
|
## Instructions
|
|
14
15
|
|
|
15
16
|
### 1. Confirm the plan
|