raptor-aios 0.1.0

package/templates/plan-template.md

@@ -0,0 +1,150 @@
+# Implementation Plan — {{featureName}}
+
+> Generated by `/rpt.plan` from `spec.md` + constitution.
+> Companion artifacts: `research.md`, `data-model.md`, `contracts/`, `quickstart.md`.
+> Spec Kit ref: E05/E09.
+
+---
+
+## Metadata
+
+- **Feature**: `{{featureDirectory}}`
+- **Spec hash**: `{{specHash}}`
+- **Generated**: `{{generatedAt}}`
+- **Constitution version**: `{{constitutionVersion}}`
+
+---
+
+## Technical Context
+
+- **Stack**: {{stack}}
+- **Runtime**: {{runtime}}
+- **Database**: {{database}}
+- **Deployment**: {{deployment}}
+- **External services**: {{externalServices}}
+
+---
+
+## Constitution Check
+
+> Read `.raptor/memory/constitution.md` and evaluate every principle.
+> If a principle is violated, the plan **must** include a justification or a redesign.
+
+### Initial Check (before Phase 1)
+
+| Principle             | Compatible? | Justification / Mitigation        |
+| --------------------- | ----------- | --------------------------------- |
+| {{principle1Name}}    | {{p1Yes}}   | {{p1Justification}}               |
+| {{principle2Name}}    | {{p2Yes}}   | {{p2Justification}}               |
+| {{principle3Name}}    | {{p3Yes}}   | {{p3Justification}}               |
+
+### Post-Design Check (after Phase 1)
+
+| Principle             | Still Compatible? | New Concerns / Mitigations        |
+| --------------------- | ----------------- | --------------------------------- |
+| {{principle1Name}}    | {{p1PostYes}}     | {{p1PostNotes}}                   |
+| {{principle2Name}}    | {{p2PostYes}}     | {{p2PostNotes}}                   |
+| {{principle3Name}}    | {{p3PostYes}}     | {{p3PostNotes}}                   |
+
+> **Gate**: any `No` without explicit mitigation = ERROR. Halt and revise.
+
+---
+
+## Architecture Overview
+
+```mermaid
+graph TD
+  Client --> API
+  API --> Service
+  Service --> Database
+```
+
+{{architectureDescription}}
+
+---
+
+## Data Model
+
+> See [`data-model.md`](data-model.md) for full schema.
+
+Highlights:
+
+- {{entity1}} — {{entity1Description}}
+- {{entity2}} — {{entity2Description}}
+
+---
+
+## Contracts
+
+> See [`contracts/`](contracts/) for full definitions.
+
+- **API endpoints**: {{apiSummary}}
+- **Events / messages**: {{eventsSummary}}
+- **Deep links**: {{deepLinksSummary}}
+
+---
+
+## Decisions
+
+1. **{{decision1Title}}** — {{decision1Description}}. **Rationale**: {{decision1Rationale}}.
+2. **{{decision2Title}}** — {{decision2Description}}. **Rationale**: {{decision2Rationale}}.
+
+---
+
+## Alternatives Considered
+
+- **{{alternative1}}** — rejected because {{rejectionReason1}}.
+- **{{alternative2}}** — rejected because {{rejectionReason2}}.
+
+---
+
+## Risks & Mitigations
+
+| Risk             | Impact     | Probability | Mitigation                |
+| ---------------- | ---------- | ----------- | ------------------------- |
+| {{risk1}}        | {{impact1}}| {{prob1}}   | {{mitigation1}}           |
+| {{risk2}}        | {{impact2}}| {{prob2}}   | {{mitigation2}}           |
+
+---
+
+## Rollout & Reversibility
+
+- **Phasing**: {{rolloutPhases}}
+- **Feature flag**: {{featureFlag}}
+- **Rollback plan**: {{rollbackPlan}}
+- **Reversibility cost**: {{reversibilityCost}}
+
+---
+
+## Observability
+
+- **Logs**: {{logsStrategy}}
+- **Metrics**: {{metricsStrategy}}
+- **Traces**: {{tracesStrategy}}
+- **Alerts**: {{alertsStrategy}}
+
+---
+
+## Phase 0 — Research
+
+See [`research.md`](research.md). Output of this phase: list of unknowns resolved + dependency picks.
+
+## Phase 1 — Technical Design
+
+Outputs:
+
+- [`data-model.md`](data-model.md)
+- [`contracts/`](contracts/)
+- [`quickstart.md`](quickstart.md)
+
+## Phase 2 — Tasks (next stage)
+
+Run `/rpt.tasks` to break this plan into a strict checklist.
+
+---
+
+## Rules
+
+1. **Constitution first**: any plan that violates an article without explicit mitigation is rejected.
+2. **Reference, don't duplicate**: link to `data-model.md`, `contracts/`, etc.; don't inline the schemas.
+3. **Idempotent**: re-running `/rpt.plan` regenerates this file from `spec.md` deterministically.

package/templates/spec-template.md

@@ -0,0 +1,116 @@
+# Feature Specification — {{featureName}}
+
+> Generated by `/rpt.specify` from a natural-language description.
+> This is the contract that downstream stages (`plan`, `tasks`, `implement`) read from.
+> Spec Kit ref: E05/E09 — first artifact in the SDD chain.
+
+---
+
+## Metadata
+
+- **Feature**: `{{featureDirectory}}`
+- **Branch**: `{{branchName}}`
+- **Number**: `{{featureNum}}`
+- **Created**: `{{generatedAt}}`
+- **Status**: draft <!-- draft | clarifying | approved | implementing | done -->
+
+---
+
+## Summary
+
+{{summaryParagraph}}
+
+---
+
+## User Stories
+
+> Format: `As a <role>, I want to <action>, so that <benefit>.`
+
+### US1 — {{us1Title}}
+
+As a {{role1}}, I want to {{action1}}, so that {{benefit1}}.
+
+**Priority**: P1 <!-- P1 | P2 | P3 -->
+
+### US2 — {{us2Title}}
+
+As a {{role2}}, I want to {{action2}}, so that {{benefit2}}.
+
+**Priority**: P2
+
+---
+
+## Acceptance Criteria
+
+> Format: `Given <precondition>, When <action>, Then <observable result>.`
+
+### AC1 — Linked to US1
+
+- **Given** {{ac1Given}}
+- **When** {{ac1When}}
+- **Then** {{ac1Then}}
+
+### AC2 — Linked to US2
+
+- **Given** {{ac2Given}}
+- **When** {{ac2When}}
+- **Then** {{ac2Then}}
+
+---
+
+## Non-Functional Requirements
+
+| Category        | Requirement                                       |
+| --------------- | ------------------------------------------------- |
+| Performance     | {{performanceRequirement}}                        |
+| Security        | {{securityRequirement}}                           |
+| Accessibility   | {{accessibilityRequirement}}                      |
+| Observability   | {{observabilityRequirement}}                      |
+| Reliability     | {{reliabilityRequirement}}                        |
+
+---
+
+## Technical Constraints
+
+- {{constraint1}}
+- {{constraint2}}
+
+---
+
+## Dependencies
+
+- {{dependency1}}
+- {{dependency2}}
+
+---
+
+## Out of Scope
+
+- {{outOfScope1}}
+- {{outOfScope2}}
+
+---
+
+## Open Questions
+
+> Mark genuine ambiguities as `[NEEDS CLARIFICATION: <question>]`. Maximum 3 items.
+
+- [NEEDS CLARIFICATION: {{question1}}]
+
+---
+
+## Success Criteria
+
+How we will know this feature is successful (measurable):
+
+- {{successMetric1}}
+- {{successMetric2}}
+
+---
+
+## Rules
+
+1. **No invention**: only capture what is in the user input plus reasonable inferences.
+2. **Testable acceptance**: prefer concrete, measurable criteria.
+3. **Bounded clarifications**: maximum 3 `[NEEDS CLARIFICATION]` tokens — beyond that, ask the user.
+4. **Source of truth**: downstream stages read this file; do not duplicate decisions in `plan.md`.

package/templates/tasks-template.md

@@ -0,0 +1,77 @@
+# Tasks Template — Strict Checklist Format
+
+#
+
+# Generated by /rpt.tasks from plan.md
+
+# Each task MUST follow the exact checklist format below
+
+#
+
+# Spec Kit ref: E10 — "Formato strict checklist tasks.md"
+
+---
+
+# Tasks — {{featureName}}
+
+> Auto-generated from `plan.md`. Do **not** edit the task IDs or status markers manually during implementation.
+
+## Metadata
+
+- **Feature**: `{{featureDirectory}}`
+- **Generated from**: `plan.md` (hash: `{{planHash}}`)
+- **Generated at**: {{generatedAt}}
+- **Total tasks**: {{totalTasks}}
+
+---
+
+## Checklist
+
+<!-- 
+Status markers:
+  - [ ] = Pending
+  - [/] = In Progress  
+  - [x] = Completed
+  - [!] = Blocked (add reason)
+-->
+
+### Group 1: {{groupName}}
+
+- [ ] **T001** — {{taskDescription}}
+  - File(s): `{{targetFiles}}`
+  - Acceptance: {{acceptanceCriteria}}
+  - Constitution: {{applicableArticles}}
+
+- [ ] **T002** — {{taskDescription}}
+  - File(s): `{{targetFiles}}`
+  - Acceptance: {{acceptanceCriteria}}
+
+---
+
+### Group N: {{groupName}}
+
+- [ ] **TNNN** — {{taskDescription}}
+  - File(s): `{{targetFiles}}`
+  - Acceptance: {{acceptanceCriteria}}
+
+---
+
+## Summary
+
+| Status | Count |
+|--------|-------|
+| Pending | {{pendingCount}} |
+| In Progress | {{inProgressCount}} |
+| Completed | {{completedCount}} |
+| Blocked | {{blockedCount}} |
+| **Total** | **{{totalTasks}}** |
+
+---
+
+## Rules
+
+1. **Task IDs are sequential**: T001, T002, ..., TNNN. Never skip or reorder.
+2. **One file per task**: Each task targets specific files. Don't mix concerns.
+3. **Status is source of truth**: `/rpt.implement` reads these markers to determine what to build.
+4. **No partial marking**: A task is `[x]` only when ALL acceptance criteria pass.
+5. **Blocked tasks**: Use `[!]` and add `Reason: <why>` on the next line.