specsmd 0.0.0-dev

package/flows/aidlc/templates/construction/standards/coding-standards.md

@@ -0,0 +1,29 @@
+# Coding Standards
+
+## General Principles
+
+- {e.g., DRY, KISS, SOLID}
+- {e.g., Clean Code practices}
+
+## Naming Conventions
+
+- Variables: {e.g., camelCase}
+- Functions: {e.g., camelCase}
+- Classes: {e.g., PascalCase}
+- Files: {e.g., kebab-case}
+
+## Formatting
+
+- Indentation: {e.g., 2 spaces}
+- Line Length: {e.g., 80 characters}
+- Braces: {e.g., K&R style}
+
+## Comments & Documentation
+
+- {e.g., JSDoc for functions}
+- {e.g., Explain WHY, not WHAT}
+
+## Testing
+
+- {e.g., Unit tests for all business logic}
+- {e.g., Integration tests for API endpoints}

package/flows/aidlc/templates/construction/standards/system-architecture.md

@@ -0,0 +1,22 @@
+# System Architecture
+
+## Overview
+
+{High-level system description}
+
+## Architecture Diagram
+
+{Mermaid diagram or description}
+
+## Components
+
+- {Component 1}: {Purpose}
+- {Component 2}: {Purpose}
+
+## Data Flow
+
+{How data moves through the system}
+
+## Technology Stack
+
+{Languages, frameworks, databases, etc.}

package/flows/aidlc/templates/construction/standards/tech-stack.md

@@ -0,0 +1,19 @@
+# Tech Stack
+
+## Core Technologies
+
+- Language: {e.g., TypeScript, Python}
+- Framework: {e.g., React, Next.js, Django}
+- Database: {e.g., PostgreSQL, MongoDB}
+
+## Infrastructure
+
+- Cloud Provider: {e.g., AWS, GCP}
+- Containerization: {e.g., Docker, Kubernetes}
+- CI/CD: {e.g., GitHub Actions}
+
+## Tools & Libraries
+
+- Testing: {e.g., Jest, Pytest}
+- Linting: {e.g., ESLint, Pylint}
+- Documentation: {e.g., MkDocs, Storybook}

package/flows/aidlc/templates/inception/inception-log-template.md

@@ -0,0 +1,134 @@
+# Inception Log Template
+
+Use this template to track inception progress and decisions for an intent.
+
+---
+
+## Location
+
+`{intents-path}/{intent}/inception-log.md`
+
+---
+
+## Template
+
+```markdown
+---
+intent: {NNN}-{intent-name}
+created: {YYYY-MM-DDTHH:MM:SSZ}
+completed: {YYYY-MM-DDTHH:MM:SSZ or null}
+status: {in-progress | complete}
+---
+
+# Inception Log: {intent-name}
+
+## Overview
+
+**Intent**: {brief description}
+**Type**: {green-field | brown-field | defect-fix | refactoring}
+**Created**: {date}
+
+## Artifacts Created
+
+| Artifact | Status | File |
+|----------|--------|------|
+| Requirements | ✅ | requirements.md |
+| System Context | ✅ | system-context.md |
+| Units | ✅ | units/{unit-name}/unit-brief.md |
+| Stories | ✅ | units/{unit-name}/stories/*.md |
+| Bolt Plan | ✅ | memory-bank/bolts/bolt-*.md |
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Functional Requirements | {n} |
+| Non-Functional Requirements | {n} |
+| Units | {n} |
+| Stories | {n} |
+| Bolts Planned | {n} |
+
+## Units Breakdown
+
+| Unit | Stories | Bolts | Priority |
+|------|---------|-------|----------|
+| {unit-1} | {n} | {n} | Must |
+| {unit-2} | {n} | {n} | Should |
+
+## Decision Log
+
+| Date | Decision | Rationale | Approved |
+|------|----------|-----------|----------|
+
+## Scope Changes
+
+| Date | Change | Reason | Impact |
+|------|--------|--------|--------|
+
+## Ready for Construction
+
+**Checklist**:
+- [ ] All requirements documented
+- [ ] System context defined
+- [ ] Units decomposed
+- [ ] Stories created for all units
+- [ ] Bolts planned
+- [ ] Human review complete
+
+## Next Steps
+
+1. Begin Construction Phase
+2. Start with Unit: {first-unit}
+3. Execute: `/specsmd-construction-agent --unit="{first-unit}"`
+
+## Dependencies
+
+{Execution order based on unit dependencies}
+```
+
+---
+
+## When to Create
+
+Create this file when:
+
+1. Intent is created (intent-create skill)
+2. Initialize with basic metadata and empty sections
+
+---
+
+## When to Update
+
+Update this file when:
+
+1. An artifact is completed (update Artifacts Created table)
+2. A decision is made during inception (add to Decision Log)
+3. Scope changes (add to Scope Changes)
+4. Inception completes (mark status complete, fill summary)
+
+---
+
+## Decision Log Examples
+
+```markdown
+## Decision Log
+
+| Date | Decision | Rationale | Approved |
+|------|----------|-----------|----------|
+| 2025-12-07 | Split auth into 2 units | Separation of concerns | Yes |
+| 2025-12-07 | Use JWT over sessions | Stateless API requirement | Yes |
+| 2025-12-08 | Add MFA to scope | Security requirement from review | Yes |
+```
+
+---
+
+## Scope Changes Examples
+
+```markdown
+## Scope Changes
+
+| Date | Change | Reason | Impact |
+|------|--------|--------|--------|
+| 2025-12-08 | Added MFA stories | Security requirement | +2 stories, +1 bolt |
+| 2025-12-09 | Removed social login | Out of scope for MVP | -3 stories, -1 bolt |
+```

package/flows/aidlc/templates/inception/project/README.md

@@ -0,0 +1,55 @@
+# Project Context
+
+This directory contains project-level context and metadata.
+
+## Purpose
+
+The `memory-bank/project/` directory stores information about your overall project that persists across all intents and units.
+
+## Files to Create
+
+- **project-brief.md**: High-level project overview, goals, and scope
+- **tech-stack.md**: Technology choices and rationale
+- **team.md**: Team structure and roles
+- **conventions.md**: Coding standards, naming conventions, etc.
+
+## Example: project-brief.md
+
+```markdown
+---
+created: 2024-11-22
+updated: 2024-11-22
+---
+
+# Project Brief
+
+## Project Name
+{Your project name}
+
+## Overview
+{Brief description of what this project does}
+
+## Business Goals
+- {Goal 1}
+- {Goal 2}
+
+## Target Users
+{Who will use this system}
+
+## Success Criteria
+- {Measurable criterion 1}
+- {Measurable criterion 2}
+
+## Timeline
+- Inception: {dates}
+- Construction: {dates}
+- Launch: {target date}
+```
+
+## Getting Started
+
+1. Create `project-brief.md` with your project overview
+2. Document your tech stack in `tech-stack.md`
+3. Add any other project-level context as needed
+
+These files will be referenced by agents throughout the AI-DLC workflow.

package/flows/aidlc/templates/inception/requirements-template.md

@@ -0,0 +1,144 @@
+# Requirements Template
+
+Use this template when documenting requirements for an intent.
+
+---
+
+## Frontmatter
+
+```yaml
+---
+intent: {NNN}-{intent-name}
+phase: inception
+status: draft|in-progress|complete
+created: {YYYY-MM-DDTHH:MM:SSZ}
+updated: {YYYY-MM-DDTHH:MM:SSZ}
+---
+```
+
+Note: All naming is derived from folder names. No prefix field needed.
+
+---
+
+## Content
+
+```markdown
+# Requirements: {Intent Name}
+
+## Intent Overview
+
+{High-level description of what this intent aims to achieve}
+
+## Business Goals
+
+| Goal | Success Metric | Priority |
+|------|----------------|----------|
+| {Goal 1} | {How to measure success} | Must |
+| {Goal 2} | {How to measure success} | Should |
+
+---
+
+## Functional Requirements
+
+### FR-1: {Requirement Title}
+- **Description**: {What the system must do}
+- **Acceptance Criteria**: {Measurable conditions for success}
+- **Priority**: Must/Should/Could
+- **Related Stories**: {Story IDs when defined}
+
+### FR-2: {Requirement Title}
+- **Description**: {What the system must do}
+- **Acceptance Criteria**: {Measurable conditions for success}
+- **Priority**: Must/Should/Could
+- **Related Stories**: {Story IDs when defined}
+
+---
+
+## Non-Functional Requirements
+
+### Performance
+| Requirement | Metric | Target |
+|-------------|--------|--------|
+| Response Time | p95 latency | < 200ms |
+| Throughput | Requests/second | > 1000 |
+
+### Scalability
+| Requirement | Metric | Target |
+|-------------|--------|--------|
+| Concurrent Users | Active sessions | 10,000 |
+| Data Volume | Records | 10M+ |
+
+### Security
+| Requirement | Standard | Notes |
+|-------------|----------|-------|
+| Authentication | OAuth 2.0 / JWT | {details} |
+| Authorization | RBAC | {details} |
+| Data Protection | AES-256 | {details} |
+
+### Reliability
+| Requirement | Metric | Target |
+|-------------|--------|--------|
+| Availability | Uptime | 99.9% |
+| Recovery | RTO | < 1 hour |
+
+### Compliance
+| Requirement | Standard | Notes |
+|-------------|----------|-------|
+| {Regulation} | {Standard} | {details} |
+
+---
+
+## Constraints
+
+### Technical Constraints
+
+**Project-wide standards**: Required standards will be loaded from memory-bank standards folder by Construction Agent
+
+**Intent-specific constraints** (only list constraints unique to this feature):
+- {Constraint specific to this intent, not covered by standards}
+
+### Business Constraints
+- {Constraint 1: e.g., budget limitation}
+- {Constraint 2: e.g., timeline requirement}
+
+---
+
+## Assumptions
+
+| Assumption | Risk if Invalid | Mitigation |
+|------------|-----------------|------------|
+| {Assumption 1} | {What happens if wrong} | {How to mitigate} |
+| {Assumption 2} | {What happens if wrong} | {How to mitigate} |
+
+---
+
+## Open Questions
+
+| Question | Owner | Due Date | Resolution |
+|----------|-------|----------|------------|
+| {Question 1} | {Who} | {When} | {Pending/Resolved} |
+```
+
+---
+
+## Priority Definitions
+
+| Priority | Meaning |
+|----------|---------|
+| **Must** | Required for MVP, system unusable without |
+| **Should** | Important, significant value but not blocking |
+| **Could** | Nice to have, enhances experience |
+| **Won't** | Out of scope for this intent |
+
+---
+
+## Requirement Quality Checklist
+
+Before marking requirements complete, verify:
+
+- [ ] All requirements are testable (measurable, not vague)
+- [ ] Acceptance criteria are binary (pass/fail)
+- [ ] NFRs have specific metrics and targets
+- [ ] Dependencies are identified
+- [ ] Constraints are documented
+- [ ] Assumptions are stated and risks assessed

package/flows/aidlc/templates/inception/stories-template.md

@@ -0,0 +1,38 @@
+---
+intent: {NNN}-{intent-name}
+phase: inception
+status: stories-created
+updated: {YYYY-MM-DDTHH:MM:SSZ}
+---
+
+# {Intent Name} - Stories
+
+## User Stories
+
+### Story-1: {Title}
+
+**As a** {user type}
+**I want** {goal}
+**So that** {benefit}
+
+**Acceptance Criteria**:
+
+- [ ] {Criterion 1}
+- [ ] {Criterion 2}
+
+**Priority**: High/Medium/Low
+**Estimate**: {T-shirt size: S/M/L/XL}
+
+### Story-2: {Title}
+
+...
+
+## Technical Stories
+
+### Tech-Story-1: {Title}
+
+**Description**: {What needs to be done technically}
+**Rationale**: {Why this is needed}
+**Acceptance Criteria**:
+
+- [ ] {Criterion}

package/flows/aidlc/templates/inception/story-template.md

@@ -0,0 +1,147 @@
+# Story Template
+
+Use this template when creating individual story files during story creation.
+
+---
+
+## Frontmatter
+
+```yaml
+---
+id: {SSS}-{title-slug}
+unit: {UUU}-{unit-name}
+intent: {NNN}-{intent-name}
+status: draft
+priority: must|should|could
+created: {YYYY-MM-DDTHH:MM:SSZ}
+assigned_bolt: null
+implemented: false
+---
+```
+
+---
+
+## Content
+
+```markdown
+# Story: {SSS}-{title-slug}
+
+## User Story
+
+**As a** {user role}
+**I want** {goal/action}
+**So that** {benefit/reason}
+
+## Acceptance Criteria
+
+- [ ] **Given** {precondition}, **When** {action}, **Then** {expected outcome}
+- [ ] **Given** {precondition}, **When** {action}, **Then** {expected outcome}
+- [ ] **Given** {precondition}, **When** {action}, **Then** {expected outcome}
+
+## Technical Notes
+
+{Implementation hints, constraints, or considerations}
+
+## Dependencies
+
+### Requires
+- {Other stories this depends on, or "None"}
+
+### Enables
+- {Stories that depend on this, or "None"}
+
+## Edge Cases
+
+| Scenario | Expected Behavior |
+|----------|-------------------|
+| {edge case 1} | {behavior} |
+| {edge case 2} | {behavior} |
+
+## Out of Scope
+
+- {What this story does NOT cover}
+```
+
+---
+
+## Priority Levels
+
+| Priority | Meaning | Criteria |
+|----------|---------|----------|
+| `must` | Required for MVP | System unusable without this |
+| `should` | Important | Significant value, not blocking |
+| `could` | Nice to have | Enhances experience |
+
+---
+
+## Status Values
+
+| Status | Meaning |
+|--------|---------|
+| `draft` | Story written, needs review |
+| `ready` | Reviewed, ready for bolt |
+| `in-progress` | Being implemented in a bolt |
+| `implemented` | Code complete |
+| `tested` | Tests passing |
+| `done` | All acceptance criteria met |
+
+---
+
+## Example
+
+```yaml
+---
+id: 001-user-signup
+unit: 001-auth-service
+intent: 001-user-authentication
+status: ready
+priority: must
+created: 2024-12-05T10:00:00Z
+assigned_bolt: 001-auth-service
+implemented: false
+---
+```
+
+```markdown
+# Story: 001-user-signup
+
+## User Story
+
+**As a** new user
+**I want** to register with my email and password
+**So that** I can access the application
+
+## Acceptance Criteria
+
+- [ ] **Given** I am on the registration page, **When** I enter valid email and password, **Then** my account is created and I receive a confirmation email
+- [ ] **Given** I enter an email that already exists, **When** I submit registration, **Then** I see an error message "Email already registered"
+- [ ] **Given** I enter a password less than 8 characters, **When** I submit, **Then** I see validation error
+
+## Technical Notes
+
+- Password must be hashed with bcrypt (cost factor 12)
+- Email validation should use RFC 5322 compliant regex
+- Rate limit registration to 5 attempts per IP per hour
+
+## Dependencies
+
+### Requires
+- None (first story)
+
+### Enables
+- 002-user-login (User login)
+- 003-email-verification (Email verification)
+
+## Edge Cases
+
+| Scenario | Expected Behavior |
+|----------|-------------------|
+| SQL injection in email | Safely escaped, validation fails |
+| Very long email (255+ chars) | Validation error |
+| Unicode in password | Allowed, properly encoded |
+
+## Out of Scope
+
+- Social login (OAuth) - separate story
+- Password reset - separate story
+```

package/flows/aidlc/templates/inception/system-context-template.md

@@ -0,0 +1,29 @@
+---
+intent: {NNN}-{intent-name}
+phase: inception
+status: context-defined
+updated: {YYYY-MM-DDTHH:MM:SSZ}
+---
+
+# {Intent Name} - System Context
+
+## System Overview
+
+{High-level description of what we are building}
+
+## Context Diagram
+
+{Mermaid diagram showing System, Users, and External Systems}
+
+## External Integrations
+
+- **System A**: {Purpose of integration}
+- **System B**: {Purpose of integration}
+
+## High-Level Constraints
+
+- {e.g., Must run on AWS, Must use existing Auth provider}
+
+## Key NFR Goals
+
+- {High-level performance/security goals to guide construction}