aios-core/.aios-core/product/templates/spec-tmpl.md

Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework

# Spec: {{story-title}}

> **Story ID:** {{story-id}}
> **Generated:** {{timestamp}}
> **Complexity:** {{complexity}}
> **Pipeline Phases:** {{phases}}

---

## 1. Overview

### 1.1 Summary

{{overview-summary}}

### 1.2 Goals

{{#each goals}}

- {{this}}
  {{/each}}

### 1.3 Non-Goals

{{#each non-goals}}

- {{this}}
  {{/each}}

---

## 2. Requirements Summary

### 2.1 Functional Requirements

| ID  | Description | Priority | Acceptance Criteria |
| --- | ----------- | -------- | ------------------- |

{{#each functional-requirements}}
| {{id}} | {{description}} | {{priority}} | {{acceptance}} |
{{/each}}

### 2.2 Non-Functional Requirements

| Category | Requirement | Target |
| -------- | ----------- | ------ |

{{#each nfr}}
| {{category}} | {{requirement}} | {{target}} |
{{/each}}

### 2.3 Constraints

{{#each constraints}}

- **{{name}}:** {{description}}
  {{/each}}

### 2.4 Assumptions

{{#each assumptions}}

- {{this}}
  {{/each}}

---

## 3. Technical Approach

### 3.1 Architecture Overview

{{architecture-overview}}

### 3.2 Key Decisions

{{#each key-decisions}}

- **{{decision}}:** {{rationale}}
  {{/each}}

### 3.3 Patterns to Use

{{#each patterns}}

- {{name}}: {{description}}
  {{/each}}

### 3.4 Implementation Strategy

{{implementation-strategy}}

---

## 4. Dependencies

### 4.1 External Dependencies

| Name | Version | Purpose | Verified |
| ---- | ------- | ------- | -------- |

{{#each external-dependencies}}
| {{name}} | {{version}} | {{purpose}} | {{verified}} |
{{/each}}

### 4.2 Internal Dependencies

{{#each internal-dependencies}}

- `{{path}}`: {{purpose}}
  {{/each}}

### 4.3 Unverified Claims

{{#if unverified-claims}}
{{#each unverified-claims}}

- ⚠️ {{claim}} - {{reason}}
  {{/each}}
  {{else}}
  _No unverified claims._
  {{/if}}

---

## 5. Files to Modify/Create

### 5.1 New Files

{{#each new-files}}

- `{{path}}` - {{purpose}}
  {{/each}}

### 5.2 Modified Files

{{#each modified-files}}

- `{{path}}` - {{changes}}
  {{/each}}

### 5.3 Deleted Files

{{#if deleted-files}}
{{#each deleted-files}}

- `{{path}}` - {{reason}}
  {{/each}}
  {{else}}
  _No files to delete._
  {{/if}}

---

## 6. Testing Strategy

### 6.1 Unit Tests

{{#each unit-tests}}

- {{description}}
  {{/each}}

### 6.2 Integration Tests

{{#each integration-tests}}

- {{description}}
  {{/each}}

### 6.3 E2E Tests

{{#if e2e-tests}}
{{#each e2e-tests}}

- {{description}}
  {{/each}}
  {{else}}
  _No E2E tests required._
  {{/if}}

### 6.4 Manual Verification

{{#each manual-verification}}

- [ ] {{description}}
      {{/each}}

---

## 7. Risks & Mitigations

| Risk | Probability | Impact | Mitigation |
| ---- | ----------- | ------ | ---------- |

{{#each risks}}
| {{risk}} | {{probability}} | {{impact}} | {{mitigation}} |
{{/each}}

---

## 8. Open Questions

{{#if open-questions}}
{{#each open-questions}}

- [ ] **Q{{@index}}:** {{question}}
  - Context: {{context}}
  - Owner: {{owner}}
    {{/each}}
    {{else}}
    _No open questions._
    {{/if}}

---

## Metadata

```yaml
spec:
  version: '1.0'
  generatedBy: spec-pipeline
  generatedAt: { { timestamp } }

inputs:
  requirements: docs/stories/{{story-id}}/spec/requirements.json
  complexity: docs/stories/{{story-id}}/spec/complexity.json
  research: docs/stories/{{story-id}}/spec/research.json

status: { { status } }
```

---

_Generated by AIOS Spec Pipeline (Epic 3)_