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.
- package/ADOPTING.md +57 -0
- package/CLAUDE.md +125 -0
- package/LICENSE +21 -0
- package/README.md +32 -0
- package/package.json +32 -0
- package/patterns/three-agent-architect-builder-reviewer/README.md +153 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/architect.md +31 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/builder.md +25 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/reviewer.md +33 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/agents/triage.md +31 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/breakdown-prd.md +18 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/build-ticket.md +12 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/nightly-issues.md +14 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/plan-ticket.md +10 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/review-ticket.md +14 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/start-milestone.md +15 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/commands/verify-delivery.md +20 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/hooks/guard-main-session-writes.mjs +53 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/scripts/publish-tickets.mjs +263 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/settings.json +15 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/workflows/nightly-issues.js +139 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/.claude/workflows/run-milestone.js +223 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/INSTALL.md +65 -0
- package/patterns/three-agent-architect-builder-reviewer/scaffold/claude-md-snippet.md +37 -0
- package/scripts/adopt.mjs +177 -0
- package/scripts/build-site.mjs +264 -0
- package/scripts/cli.mjs +52 -0
- package/templates/pattern-README.template.md +65 -0
- package/templates/ticket.template.md +104 -0
- package/templates/tracker/github/ISSUE_TEMPLATE/bug-report.md +28 -0
- package/templates/tracker/github/ISSUE_TEMPLATE/decision-record.md +25 -0
- package/templates/tracker/github/ISSUE_TEMPLATE/task.md +36 -0
- package/templates/tracker/github/PULL_REQUEST_TEMPLATE.md +54 -0
- package/templates/tracker/gitlab/issue_templates/bug-report.md +23 -0
- package/templates/tracker/gitlab/issue_templates/decision-record.md +20 -0
- package/templates/tracker/gitlab/issue_templates/task.md +31 -0
- 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. -->
|