agents-templated 2.2.11 → 2.2.13

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.
Files changed (85) hide show
  1. package/README.md +34 -8
  2. package/bin/cli.js +49 -0
  3. package/lib/orchestrator.js +562 -0
  4. package/lib/workflow.js +478 -22
  5. package/package.json +1 -1
  6. package/templates/.claude/agents/README.md +15 -1
  7. package/templates/.claude/agents/architect.md +79 -106
  8. package/templates/.claude/agents/backend-specialist.md +79 -0
  9. package/templates/.claude/agents/build-error-resolver.md +78 -119
  10. package/templates/.claude/agents/code-reviewer.md +79 -116
  11. package/templates/.claude/agents/compatibility-checker.md +79 -79
  12. package/templates/.claude/agents/configuration-validator.md +79 -85
  13. package/templates/.claude/agents/database-migrator.md +79 -83
  14. package/templates/.claude/agents/dependency-auditor.md +79 -92
  15. package/templates/.claude/agents/deployment-specialist.md +91 -0
  16. package/templates/.claude/agents/doc-updater.md +78 -130
  17. package/templates/.claude/agents/e2e-runner.md +78 -122
  18. package/templates/.claude/agents/frontend-specialist.md +79 -0
  19. package/templates/.claude/agents/load-tester.md +79 -80
  20. package/templates/.claude/agents/performance-profiler.md +79 -103
  21. package/templates/.claude/agents/performance-specialist.md +91 -0
  22. package/templates/.claude/agents/planner.md +81 -87
  23. package/templates/.claude/agents/qa-specialist.md +92 -0
  24. package/templates/.claude/agents/refactor-cleaner.md +79 -137
  25. package/templates/.claude/agents/release-ops-specialist.md +80 -0
  26. package/templates/.claude/agents/security-reviewer.md +80 -138
  27. package/templates/.claude/agents/tdd-guide.md +79 -98
  28. package/templates/.claude/agents/test-data-builder.md +79 -0
  29. package/templates/CLAUDE.md +10 -0
  30. package/templates/README.md +36 -8
  31. package/templates/agent-docs/ARCHITECTURE.md +6 -0
  32. package/templates/agents/commands/README.md +81 -8
  33. package/templates/agents/commands/SCHEMA.md +21 -1
  34. package/templates/agents/commands/arch-check.md +58 -33
  35. package/templates/agents/commands/audit.md +58 -38
  36. package/templates/agents/commands/debug-track.md +58 -33
  37. package/templates/agents/commands/docs.md +58 -34
  38. package/templates/agents/commands/fix.md +58 -34
  39. package/templates/agents/commands/learn-loop.md +58 -33
  40. package/templates/agents/commands/perf.md +58 -34
  41. package/templates/agents/commands/plan.md +58 -34
  42. package/templates/agents/commands/pr.md +58 -35
  43. package/templates/agents/commands/problem-map.md +58 -33
  44. package/templates/agents/commands/release-ready.md +58 -33
  45. package/templates/agents/commands/release.md +58 -39
  46. package/templates/agents/commands/risk-review.md +58 -33
  47. package/templates/agents/commands/scope-shape.md +58 -33
  48. package/templates/agents/commands/task.md +58 -35
  49. package/templates/agents/commands/test-data.md +56 -0
  50. package/templates/agents/commands/test.md +58 -34
  51. package/templates/agents/commands/ux-bar.md +58 -33
  52. package/templates/agents/skills/README.md +9 -0
  53. package/templates/agents/skills/debug-skill/SKILL.md +39 -0
  54. package/templates/agents/skills/feature-forge/SKILL.md +39 -0
  55. package/templates/agents/skills/secure-code-guardian/SKILL.md +39 -0
  56. package/agents/commands/README.md +0 -70
  57. package/agents/commands/SCHEMA.md +0 -22
  58. package/agents/commands/arch-check.md +0 -33
  59. package/agents/commands/audit.md +0 -38
  60. package/agents/commands/debug-track.md +0 -33
  61. package/agents/commands/docs-sync.md +0 -33
  62. package/agents/commands/docs.md +0 -34
  63. package/agents/commands/fix.md +0 -34
  64. package/agents/commands/learn-loop.md +0 -33
  65. package/agents/commands/perf-scan.md +0 -33
  66. package/agents/commands/perf.md +0 -34
  67. package/agents/commands/plan.md +0 -34
  68. package/agents/commands/pr.md +0 -35
  69. package/agents/commands/problem-map.md +0 -33
  70. package/agents/commands/quality-gate.md +0 -33
  71. package/agents/commands/refactor.md +0 -34
  72. package/agents/commands/release-ready.md +0 -33
  73. package/agents/commands/release.md +0 -39
  74. package/agents/commands/risk-review.md +0 -33
  75. package/agents/commands/scaffold.md +0 -34
  76. package/agents/commands/scope-shape.md +0 -33
  77. package/agents/commands/task.md +0 -35
  78. package/agents/commands/test.md +0 -34
  79. package/agents/commands/ux-bar.md +0 -33
  80. package/agents/rules/planning.mdc +0 -69
  81. package/templates/agents/commands/docs-sync.md +0 -33
  82. package/templates/agents/commands/perf-scan.md +0 -33
  83. package/templates/agents/commands/quality-gate.md +0 -33
  84. package/templates/agents/commands/refactor.md +0 -34
  85. package/templates/agents/commands/scaffold.md +0 -34
@@ -1,34 +0,0 @@
1
- # /scaffold
2
-
3
- ## A. Intent
4
- Create deterministic project/module boilerplate with secure defaults.
5
-
6
- ## B. When to Use
7
- Use to initialize new modules/features with approved structure.
8
-
9
- ## C. Required Inputs
10
- - Target module name
11
- - Runtime/stack
12
- - Required patterns
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Validate target path non-conflict.
16
- 2. Resolve scaffold template.
17
- 3. Generate file tree.
18
- 4. Apply secure defaults.
19
- 5. Generate baseline tests.
20
- 6. Emit scaffold manifest.
21
-
22
- ## E. Structured Output Template
23
- - `target`
24
- - `template_source`
25
- - `files_created[]`
26
- - `secure_defaults[]`
27
- - `tests_created[]`
28
-
29
- ## F. Stop Conditions
30
- - Path collision.
31
- - Unsupported template/runtime.
32
-
33
- ## G. Safety Constraints
34
- - Do not overwrite existing files without explicit confirmation.
@@ -1,33 +0,0 @@
1
- # /scope-shape
2
-
3
- ## A. Intent
4
- Constrain scope to the smallest high-leverage release that still proves value.
5
-
6
- ## B. When to Use
7
- Use after problem framing and before architecture planning.
8
-
9
- ## C. Required Inputs
10
- - Problem frame
11
- - Candidate feature list
12
- - Delivery constraints
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Rank features by impact and effort.
16
- 2. Define must-have vs defer list.
17
- 3. Freeze first-release boundaries.
18
- 4. Add explicit out-of-scope items.
19
- 5. Emit scope decision rationale.
20
-
21
- ## E. Structured Output Template
22
- - `scope_in[]`
23
- - `scope_out[]`
24
- - `tradeoffs[]`
25
- - `release_goal`
26
- - `defer_queue[]`
27
-
28
- ## F. Stop Conditions
29
- - Scope still exceeds constraints.
30
- - No out-of-scope list produced.
31
-
32
- ## G. Safety Constraints
33
- - Prefer one reversible release over broad irreversible scope.
@@ -1,35 +0,0 @@
1
- # /task
2
-
3
- ## A. Intent
4
- Convert a plan item into a deterministic execution task.
5
-
6
- ## B. When to Use
7
- Use for bounded work with clear acceptance criteria.
8
-
9
- ## C. Required Inputs
10
- - Task identifier
11
- - Acceptance criteria
12
- - Allowed scope
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Resolve task identifier.
16
- 2. Validate acceptance criteria completeness.
17
- 3. Validate scope boundaries.
18
- 4. Define execution steps.
19
- 5. Define verification steps.
20
- 6. Emit task contract.
21
-
22
- ## E. Structured Output Template
23
- - `task_id`
24
- - `objective`
25
- - `allowed_scope`
26
- - `execution_steps[]`
27
- - `verification_steps[]`
28
- - `acceptance_criteria[]`
29
-
30
- ## F. Stop Conditions
31
- - Unknown task identifier.
32
- - Missing acceptance criteria.
33
-
34
- ## G. Safety Constraints
35
- - Reject out-of-scope changes.
@@ -1,34 +0,0 @@
1
- # /test
2
-
3
- ## A. Intent
4
- Generate or execute deterministic test plans and test artifacts.
5
-
6
- ## B. When to Use
7
- Use for feature validation, regression prevention, and release readiness.
8
-
9
- ## C. Required Inputs
10
- - Target scope
11
- - Test level
12
- - Expected behavior
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Resolve test scope.
16
- 2. Map behavior to test cases.
17
- 3. Execute or generate tests.
18
- 4. Capture pass/fail artifacts.
19
- 5. Classify failures.
20
- 6. Emit test report.
21
-
22
- ## E. Structured Output Template
23
- - `scope`
24
- - `test_matrix[]`
25
- - `execution_results[]`
26
- - `coverage_delta`
27
- - `failures[]`
28
-
29
- ## F. Stop Conditions
30
- - Unavailable runtime.
31
- - Undefined scope.
32
-
33
- ## G. Safety Constraints
34
- - Do not mark success if critical tests are skipped.
@@ -1,33 +0,0 @@
1
- # /ux-bar
2
-
3
- ## A. Intent
4
- Set a minimum UX quality bar with clear criteria before UI implementation.
5
-
6
- ## B. When to Use
7
- Use when a feature has user-facing interaction or visual design impact.
8
-
9
- ## C. Required Inputs
10
- - Target user flow
11
- - Existing design language
12
- - Accessibility requirements
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Evaluate key interaction states.
16
- 2. Check visual hierarchy and clarity.
17
- 3. Validate accessibility coverage.
18
- 4. Identify UX risks and gaps.
19
- 5. Emit UX quality checklist.
20
-
21
- ## E. Structured Output Template
22
- - `ux_scorecard[]`
23
- - `interaction_states[]`
24
- - `accessibility_checks[]`
25
- - `ux_gaps[]`
26
- - `improvements[]`
27
-
28
- ## F. Stop Conditions
29
- - Critical flow has undefined state handling.
30
- - Accessibility constraints are missing.
31
-
32
- ## G. Safety Constraints
33
- - Preserve existing design system patterns unless an explicit redesign is approved.
@@ -1,69 +0,0 @@
1
- ---
2
- title: "Planning Discipline"
3
- description: "Every feature discussion or implementation must produce a reusable prompt plan file in .github/prompts/"
4
- version: "1.0.0"
5
- tags: ["planning", "workflow", "documentation", "prompts"]
6
- alwaysApply: true
7
- ---
8
-
9
- ## Purpose
10
-
11
- Ensure every feature discussion, design decision, or implementation produces a reusable prompt plan stored in `.github/prompts/`. Plans persist across sessions and serve as living context for future work — they are never discarded.
12
-
13
- ## When to Apply
14
-
15
- This rule is always active. Trigger when:
16
-
17
- - User asks to implement a new feature
18
- - A design or architecture decision is being made
19
- - A significant refactor is planned
20
- - A bug fix requires non-trivial investigation or systemic changes
21
- - A discussion produces decisions that affect future work
22
-
23
- ## Plan File Convention
24
-
25
- **Location:** `.github/prompts/`
26
- **Filename:** `YYYY-MM-DD-{feature-slug}.prompt.md`
27
- **Format:** VS Code reusable prompt (`.prompt.md` — usable as an `@workspace` prompt in Copilot Chat)
28
-
29
- ## Required Sections
30
-
31
- Each plan file must contain:
32
-
33
- ```
34
- ---
35
- agent: agent
36
- description: One-line summary of what this plan covers.
37
- ---
38
-
39
- ## Context
40
- Brief background — what problem are we solving and why now.
41
-
42
- ## Decision
43
- What we decided to do and the reasoning behind it (not just what, but why).
44
-
45
- ## Steps
46
- Numbered implementation steps in dependency order.
47
-
48
- ## Acceptance Criteria
49
- Concrete, testable outcomes that define "done".
50
-
51
- ## Status
52
- - [ ] Not started / [ ] In progress / [x] Complete
53
- Blockers (if any):
54
- ```
55
-
56
- ## Workflow
57
-
58
- 1. At the start of any feature discussion or implementation, create the plan file immediately.
59
- 2. Use the filename convention: `YYYY-MM-DD-{feature-slug}.prompt.md`.
60
- 3. Fill out **Context**, **Decision**, and **Steps** before starting implementation.
61
- 4. Update **Status** and **Acceptance Criteria** incrementally as work progresses.
62
- 5. Mark the plan complete when implementation is verified and accepted.
63
-
64
- ## Guardrails
65
-
66
- - Do not skip plan creation for "small" features — small decisions accumulate into undocumented technical debt.
67
- - Plans are never deleted — they form a historical record of architectural decisions.
68
- - Plan files must not contain secrets, credentials, or PII.
69
- - If a plan changes significantly mid-implementation, update it in place rather than creating a new one.
@@ -1,33 +0,0 @@
1
- # /docs-sync
2
-
3
- ## A. Intent
4
- Keep documentation aligned with shipped behavior and contract changes.
5
-
6
- ## B. When to Use
7
- Use after implementation or release-prep changes.
8
-
9
- ## C. Required Inputs
10
- - Code changes summary
11
- - Updated behavior/contracts
12
- - Target documentation set
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Identify behavior and API changes.
16
- 2. Locate affected docs.
17
- 3. Update docs with minimal accurate edits.
18
- 4. Verify examples and command references.
19
- 5. Emit documentation update summary.
20
-
21
- ## E. Structured Output Template
22
- - `docs_updated[]`
23
- - `behavior_changes[]`
24
- - `contract_updates[]`
25
- - `example_checks[]`
26
- - `remaining_doc_gaps[]`
27
-
28
- ## F. Stop Conditions
29
- - Behavior changed with no corresponding doc update.
30
- - Example commands are unverified.
31
-
32
- ## G. Safety Constraints
33
- - Do not publish stale setup or command instructions.
@@ -1,33 +0,0 @@
1
- # /perf-scan
2
-
3
- ## A. Intent
4
- Measure baseline performance and detect regressions with deterministic thresholds.
5
-
6
- ## B. When to Use
7
- Use before and after performance-sensitive changes.
8
-
9
- ## C. Required Inputs
10
- - Baseline context
11
- - Target endpoints or flows
12
- - Performance thresholds
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Capture baseline metrics.
16
- 2. Execute candidate workload.
17
- 3. Compare p95/p99 latency and error rates.
18
- 4. Flag regressions with threshold deltas.
19
- 5. Emit optimization priorities.
20
-
21
- ## E. Structured Output Template
22
- - `baseline_metrics`
23
- - `candidate_metrics`
24
- - `regressions[]`
25
- - `threshold_checks[]`
26
- - `recommendations[]`
27
-
28
- ## F. Stop Conditions
29
- - Baseline missing.
30
- - Thresholds undefined.
31
-
32
- ## G. Safety Constraints
33
- - Avoid performance claims without before/after evidence.
@@ -1,33 +0,0 @@
1
- # /quality-gate
2
-
3
- ## A. Intent
4
- Enforce quality gates using test signals, behavior checks, and regression controls.
5
-
6
- ## B. When to Use
7
- Use before release, and after major bug fixes.
8
-
9
- ## C. Required Inputs
10
- - Target build/revision
11
- - Test scope
12
- - Critical user flows
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Run required test layers.
16
- 2. Validate critical user flows.
17
- 3. Inspect flaky or unstable results.
18
- 4. Define required remediations.
19
- 5. Emit pass/conditional/block outcome.
20
-
21
- ## E. Structured Output Template
22
- - `test_results[]`
23
- - `critical_flow_status[]`
24
- - `quality_findings[]`
25
- - `required_fixes[]`
26
- - `gate_status`
27
-
28
- ## F. Stop Conditions
29
- - Critical flow untested.
30
- - Required tests failed.
31
-
32
- ## G. Safety Constraints
33
- - Do not mark pass when critical regressions remain open.
@@ -1,34 +0,0 @@
1
- # /refactor
2
-
3
- ## A. Intent
4
- Improve internal structure without changing externally observable behavior.
5
-
6
- ## B. When to Use
7
- Use for maintainability and modularity improvements.
8
-
9
- ## C. Required Inputs
10
- - Target component/module
11
- - Non-functional goals
12
- - Behavior invariants
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Capture behavior invariants.
16
- 2. Define refactor units.
17
- 3. Apply one unit at a time.
18
- 4. Verify invariants after each unit.
19
- 5. Measure complexity delta.
20
- 6. Emit refactor report.
21
-
22
- ## E. Structured Output Template
23
- - `target`
24
- - `invariants[]`
25
- - `transformations[]`
26
- - `behavior_check_results[]`
27
- - `complexity_delta`
28
-
29
- ## F. Stop Conditions
30
- - Invariant violation.
31
- - Missing baseline behavior.
32
-
33
- ## G. Safety Constraints
34
- - Abort on behavior-change risk.
@@ -1,34 +0,0 @@
1
- # /scaffold
2
-
3
- ## A. Intent
4
- Create deterministic project/module boilerplate with secure defaults.
5
-
6
- ## B. When to Use
7
- Use to initialize new modules/features with approved structure.
8
-
9
- ## C. Required Inputs
10
- - Target module name
11
- - Runtime/stack
12
- - Required patterns
13
-
14
- ## D. Deterministic Execution Flow
15
- 1. Validate target path non-conflict.
16
- 2. Resolve scaffold template.
17
- 3. Generate file tree.
18
- 4. Apply secure defaults.
19
- 5. Generate baseline tests.
20
- 6. Emit scaffold manifest.
21
-
22
- ## E. Structured Output Template
23
- - `target`
24
- - `template_source`
25
- - `files_created[]`
26
- - `secure_defaults[]`
27
- - `tests_created[]`
28
-
29
- ## F. Stop Conditions
30
- - Path collision.
31
- - Unsupported template/runtime.
32
-
33
- ## G. Safety Constraints
34
- - Do not overwrite existing files without explicit confirmation.