agent-templates 0.1.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.
Files changed (37) hide show
  1. package/ADOPTING.md +57 -0
  2. package/CLAUDE.md +125 -0
  3. package/LICENSE +21 -0
  4. package/README.md +32 -0
  5. package/package.json +32 -0
  6. package/patterns/three-agent-architect-builder-reviewer/README.md +153 -0
  7. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/architect.md +31 -0
  8. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/builder.md +25 -0
  9. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/reviewer.md +33 -0
  10. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/triage.md +31 -0
  11. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/breakdown-prd.md +18 -0
  12. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/build-ticket.md +12 -0
  13. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/nightly-issues.md +14 -0
  14. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/plan-ticket.md +10 -0
  15. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/review-ticket.md +14 -0
  16. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/start-milestone.md +15 -0
  17. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/verify-delivery.md +20 -0
  18. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/hooks/guard-main-session-writes.mjs +53 -0
  19. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/scripts/publish-tickets.mjs +263 -0
  20. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/settings.json +15 -0
  21. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/workflows/nightly-issues.js +139 -0
  22. package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/workflows/run-milestone.js +223 -0
  23. package/patterns/three-agent-architect-builder-reviewer/scaffold/INSTALL.md +65 -0
  24. package/patterns/three-agent-architect-builder-reviewer/scaffold/claude-md-snippet.md +37 -0
  25. package/scripts/adopt.mjs +177 -0
  26. package/scripts/build-site.mjs +264 -0
  27. package/scripts/cli.mjs +52 -0
  28. package/templates/pattern-README.template.md +65 -0
  29. package/templates/ticket.template.md +104 -0
  30. package/templates/tracker/github/ISSUE_TEMPLATE/bug-report.md +28 -0
  31. package/templates/tracker/github/ISSUE_TEMPLATE/decision-record.md +25 -0
  32. package/templates/tracker/github/ISSUE_TEMPLATE/task.md +36 -0
  33. package/templates/tracker/github/PULL_REQUEST_TEMPLATE.md +54 -0
  34. package/templates/tracker/gitlab/issue_templates/bug-report.md +23 -0
  35. package/templates/tracker/gitlab/issue_templates/decision-record.md +20 -0
  36. package/templates/tracker/gitlab/issue_templates/task.md +31 -0
  37. package/templates/tracker/gitlab/merge_request_templates/default.md +55 -0
@@ -0,0 +1,20 @@
1
+ <!-- GitLab description template ("decision-record"). Records what was done and why —
2
+ the durable memory that commits cannot carry. Apply the decision-record label. -->
3
+
4
+ **What** (merged in <commit/PR/MR>, YYYY-MM-DD): <one paragraph — the change as shipped.>
5
+
6
+ **Key decisions & why**
7
+
8
+ <!-- One bullet per decision: the decision, its reason, and the rejected alternative when
9
+ one was seriously considered. Cite sources — official docs, ADRs, maintainer direction
10
+ with date — the same grounding discipline as everything else. -->
11
+
12
+ -
13
+
14
+ **Evidence**
15
+
16
+ <!-- Test results, verification records, links to the docs where each decision landed. -->
17
+
18
+ **Links**
19
+
20
+ <!-- Related issues / MRs / ADRs / tickets. -->
@@ -0,0 +1,31 @@
1
+ <!-- GitLab description template ("task"). Mirrors the pipeline's ticket format
2
+ so triage can convert it mechanically. -->
3
+
4
+ ## Traceability
5
+
6
+ <!-- What this implements or follows from: PRD §/FR, an ADR, a discussion, an upstream
7
+ pattern — with links. If the decision is already made somewhere, say where. -->
8
+
9
+ ## Background + basis
10
+
11
+ <!-- Why this is needed. Cite claims; quote the load-bearing sentences rather than
12
+ paraphrasing from memory. -->
13
+
14
+ ## Goal
15
+
16
+ <!-- One paragraph: the artifact(s) to produce and where they land — checkable. -->
17
+
18
+ ## Non-goals
19
+
20
+ <!-- Each exclusion names its owner or standing reason: "No X — that is MOD-02" /
21
+ "No Y — stays out of scope per PRD §Z; do not add it as a side effect." -->
22
+
23
+ ## Affected area (best guess)
24
+
25
+ <!-- Files/modules if known; the Architect finalizes the file-scope and the
26
+ does-not-touch list. -->
27
+
28
+ ## Acceptance
29
+
30
+ <!-- Checkable criteria, one per line, tagged with the repo's class vocabulary if you can
31
+ (defaults: [machine]/[fixture]/[human]). Prefer runnable checks ("command X exits 0"). -->
@@ -0,0 +1,55 @@
1
+ <!-- GitLab MR description template ("default"). "Closes #N" auto-closes on merge to the
2
+ default branch — the pipeline relies on this; never remove the reference. -->
3
+
4
+ ## Summary
5
+
6
+ <!-- What does this MR do? One sentence. -->
7
+
8
+ ## Related issue / ticket
9
+
10
+ <!-- Closes #N — plus the ticket id, e.g. [MOD-NN]. The ticket FILE stays the content
11
+ source of truth; the issue holds state. -->
12
+
13
+ ## Type
14
+
15
+ - [ ] `feat` — new feature
16
+ - [ ] `fix` — bug fix
17
+ - [ ] `refactor` — restructuring, no behavior change
18
+ - [ ] `docs` — documentation / ADR only
19
+ - [ ] `test` — new or updated tests
20
+ - [ ] `ci` / `chore` — tooling, maintenance
21
+
22
+ ## Changes
23
+
24
+ <!-- Bullets: what changed AND why. Include what was tried and rejected if it shaped the result. -->
25
+
26
+ -
27
+
28
+ ## Design note
29
+
30
+ <!-- Hard-to-reverse or non-obvious changes: link the ADR (docs/adr/NNNN-*.md) — add one if
31
+ this is a durable decision. Otherwise summarize inline: problem · affected components ·
32
+ contract/schema changes · risks. -->
33
+
34
+ ## Pipeline evidence
35
+
36
+ <!-- Assumes the installed pattern; the three-agent pattern's items are shown — adapt if
37
+ this repo runs a different pattern. -->
38
+
39
+ - [ ] Plan: `docs/plans/<ticket-id>.md` (link)
40
+ - [ ] Builder: REAL test output attached (unit / integration / E2E as the ticket requires) — never "should pass"
41
+ - [ ] Reviewer verdict: **CLEAR**, from a fresh context (link or paste the note; bounces: <n>)
42
+ - [ ] Deviations from the plan recorded (or "none")
43
+ - [ ] Post-merge: `/verify-delivery <ticket-id>` runs — the issue closes only after it passes
44
+
45
+ ## Constraint check
46
+
47
+ <!-- At install time, copy this repo's non-negotiables from its CLAUDE.md here as
48
+ checkboxes. Tick what this MR touches; mark the rest N/A. Two universal items: -->
49
+
50
+ - [ ] No hardcoded secrets (keys, tokens, credentials) in code / config / logs / docs
51
+ - [ ] Docs / ADR / ticket updated if behavior or a decision changed (feedback obligation)
52
+
53
+ ## Evidence
54
+
55
+ <!-- Test output, before/after screenshots (UI), command + output (CLI/API), or a short repro. -->