@cxi-lmai/ci-agent-platform 3.0.0

package/payload/templates/spec-issue.template.md

@@ -0,0 +1,64 @@
+<!--
+  Spec template for issues intended for autonomous implementation (the ready
+  label). Fill in every mandatory section before applying the label.
+
+  IMPORTANT: the eight section headers below (## 1. Outcome ... ## 8. Out of
+  Scope) are load-bearing. The pipeline validates decomposed sub-issues against
+  them (see lib/issue-loop.sh, pipe_validate_decomposition). If you rename a
+  header or change a placeholder token here, update that validator to match.
+
+  Copy this file to the path in PIPE_SPEC_TEMPLATE_PATH
+  (GitLab default .gitlab/issue_templates/Spec.md,
+   GitHub default .github/ISSUE_TEMPLATE/spec.md).
+-->
+
+> Fill this into the issue DESCRIPTION, not a comment. The pipeline reads only the description for the spec check.
+
+## 1. Outcome
+<!-- <one sentence>: what observable thing is true once this issue is closed?
+     Phrase as a state, not an activity. -->
+TODO
+
+## 2. Context & Motivation
+<!-- <why now>: the bug, request, or requirement that motivates this. 2-3 sentences. -->
+TODO
+
+## 3. Acceptance Criteria
+<!-- Observable, testable behaviors. At least two, each independently checkable. -->
+- [ ] TODO
+- [ ] TODO
+
+## 4. Scope Envelope
+<!-- Be honest about size. One coder session handles roughly the capacity in the
+     pipeline config (default ~15 files / ~600 lines). Larger work is decomposed. -->
+- Estimated files touched: TODO
+- Layers / packages affected: TODO
+- Fits in one coder session: TODO (yes / no; if no, decompose first)
+
+## 5. Existing Code Anchors
+<!-- <at least one> pointer to model the implementation after: a class, a module,
+     a docs page, or all three. Prevents pattern drift. -->
+- Model after: TODO
+- Relevant docs: TODO
+
+## 6. Risk Flags
+<!-- Check any that apply. Each checked box may trigger a specialist reviewer and
+     changes how the coder approaches the work. -->
+- [ ] Schema migration
+- [ ] Security-sensitive (auth, permissions, tenant isolation, secrets)
+- [ ] Public API contract change
+- [ ] Performance-critical (hot path, large query, batch job, N+1-prone)
+
+## 7. Test Plan
+<!-- <what will be tested> and how we will know it works. Be specific. -->
+- New tests to add: TODO
+- Existing tests that must still pass: TODO
+
+## 8. Out of Scope
+<!-- What this issue deliberately does NOT include. Prevents scope creep. -->
+- TODO
+
+<!-- Dependencies (GitHub has no native issue links): to say this issue waits on
+     another, write "Blocked by #N" here. The orchestrator's release poll reads
+     it back and promotes the issue once #N closes. On GitLab, native issue
+     links are used instead. -->