@comfanion/workflow 4.1.2 → 4.3.0

package/src/opencode/templates/adr-template.md

@@ -1,115 +0,0 @@
-# ADR-NNN: [Title]
-
-**Status:** Proposed | Accepted | Deprecated | Superseded
-**Date:** YYYY-MM-DD
-**Deciders:** [List of people involved]
-**Supersedes:** [ADR-XXX if applicable]
-**Superseded by:** [ADR-XXX if applicable]
-
----
-
-## Context
-
-[What is the issue that we're seeing that is motivating this decision or change?]
-
-[Describe the forces at play (technical, political, social, project). These forces are probably in tension.]
-
----
-
-## Decision
-
-[What is the change that we're proposing and/or doing?]
-
-**We will [decision].**
-
----
-
-## Consequences
-
-### Positive
-
-- [Benefit 1]
-- [Benefit 2]
-- [Benefit 3]
-
-### Negative
-
-- [Drawback 1]
-- [Drawback 2]
-
-### Neutral
-
-- [Trade-off 1]
-- [Trade-off 2]
-
----
-
-## Options Considered
-
-### Option 1: [Name]
-
-**Description:** [What this option entails]
-
-**Pros:**
-- [Pro 1]
-- [Pro 2]
-
-**Cons:**
-- [Con 1]
-- [Con 2]
-
-### Option 2: [Name]
-
-**Description:** [What this option entails]
-
-**Pros:**
-- [Pro 1]
-
-**Cons:**
-- [Con 1]
-
-### Option 3: [Name] (Chosen)
-
-**Description:** [What this option entails]
-
-**Pros:**
-- [Pro 1]
-- [Pro 2]
-
-**Cons:**
-- [Con 1]
-
-**Why chosen:** [Why this option was selected over others]
-
----
-
-## Implementation
-
-[If applicable, describe how this decision will be implemented]
-
-### Action Items
-
-- [ ] [Action 1]
-- [ ] [Action 2]
-- [ ] [Action 3]
-
-### Timeline
-
-| Phase | Description | Target Date |
-|-------|-------------|-------------|
-| Phase 1 | [Description] | YYYY-MM-DD |
-| Phase 2 | [Description] | YYYY-MM-DD |
-
----
-
-## Related
-
-- [Link to related ADR]
-- [Link to related documentation]
-- [Link to relevant code/PR]
-
----
-
-## Notes
-
-[Any additional notes, context, or information]

package/src/opencode/templates/architecture-template.md

@@ -1,362 +0,0 @@
-# [Project Name] - Architecture Document
-
-**Author:** [Name]
-**Date:** [YYYY-MM-DD]
-**Version:** [X.Y]
-**Status:** Draft | Review | Approved
-
----
-
-## Architecture Overview
-
-### System Context
-
-[High-level description of system boundaries and external actors]
-
-```
-                    ┌─────────────────────────────────────────┐
-                    │           External Systems              │
-                    │  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
-                    │  │  PIM    │  │   DAX   │  │ Payment │ │
-                    │  └────┬────┘  └────┬────┘  └────┬────┘ │
-                    └───────┼────────────┼────────────┼──────┘
-                            │            │            │
-                    ┌───────▼────────────▼────────────▼──────┐
-                    │              API Gateway                │
-                    └───────────────────┬────────────────────┘
-                                        │
-                    ┌───────────────────▼────────────────────┐
-                    │            Your System                  │
-                    │  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
-                    │  │Module A │  │Module B │  │Module C │ │
-                    │  └─────────┘  └─────────┘  └─────────┘ │
-                    └─────────────────────────────────────────┘
-```
-
-### Architecture Style
-
-| Aspect | Choice | Rationale |
-|--------|--------|-----------|
-| Overall | Modular Monolith / Microservices | [Why] |
-| Communication | REST + Kafka Events | [Why] |
-| Data | PostgreSQL + Redis | [Why] |
-| Deployment | Kubernetes | [Why] |
-
-### Key Decisions Summary
-
-| Decision | Choice | ADR |
-|----------|--------|-----|
-| [Decision 1] | [Choice] | ADR-001 |
-| [Decision 2] | [Choice] | ADR-002 |
-
----
-
-## Module/Service Architecture
-
-### [Module 1 Name]
-
-**Responsibility:** [Single responsibility description]
-
-#### Boundaries
-
-| Aspect | Details |
-|--------|---------|
-| **Owns** | [Entities/data this module owns] |
-| **Consumes** | [Events/APIs it consumes from other modules] |
-| **Produces** | [Events/APIs it produces for other modules] |
-
-#### Internal Structure
-
-```
-module-name/
-├── domain/              # Business logic (NO infrastructure imports!)
-│   ├── aggregate/       # Entities with business rules
-│   │   └── entity.go
-│   ├── valueobject/     # Immutable value objects
-│   │   └── entity_id.go
-│   ├── service/         # Domain services
-│   └── repository/      # Repository INTERFACES (ports)
-│       └── entity_repository.go
-├── application/         # Use cases (orchestration)
-│   └── usecase/
-│       └── CreateEntity/
-│           ├── inport.go    # Interface
-│           ├── dto.go       # Command & Result
-│           ├── handler.go   # Orchestration
-│           └── mappers.go   # Explicit mapping
-└── infrastructure/      # Adapters (implements ports)
-    ├── repo/            # Database implementations
-    ├── http/            # HTTP handlers, routes
-    └── kafka/           # Event bus implementations
-```
-
-#### API Endpoints
-
-| Method | Endpoint | Description | Auth |
-|--------|----------|-------------|------|
-| POST | /api/v1/entities | Create entity | JWT |
-| GET | /api/v1/entities/{id} | Get entity | JWT |
-| PUT | /api/v1/entities/{id} | Update entity | JWT |
-
-#### Events
-
-| Event | Direction | Description |
-|-------|-----------|-------------|
-| entity.created | Produces | When entity is created |
-| other.event | Consumes | Triggers action X |
-
----
-
-### [Module 2 Name]
-
-**Responsibility:** [Single responsibility description]
-
-[Same structure as above...]
-
----
-
-## Data Architecture
-
-### Database Design
-
-#### [Table 1 Name]
-
-```sql
-CREATE TABLE entities (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    name VARCHAR(255) NOT NULL,
-    status VARCHAR(50) NOT NULL,
-    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-    version INTEGER NOT NULL DEFAULT 1  -- Optimistic locking
-);
-
--- Indexes
-CREATE INDEX idx_entities_status ON entities(status);
-CREATE INDEX idx_entities_name_trgm ON entities USING gin(name gin_trgm_ops);
-```
-
-#### Entity Relationship Diagram
-
-```
-┌──────────────┐       ┌──────────────┐
-│   Entity A   │       │   Entity B   │
-├──────────────┤       ├──────────────┤
-│ id (PK)      │──────<│ entity_a_id  │
-│ name         │       │ id (PK)      │
-│ status       │       │ data         │
-└──────────────┘       └──────────────┘
-```
-
-### Data Flow
-
-```
-[External] → [API Gateway] → [Module A] → [Database]
-                                │
-                                ▼
-                          [Kafka Topic]
-                                │
-                                ▼
-                          [Module B] → [External System]
-```
-
-### Event Schema
-
-#### entity.created
-
-```json
-{
-  "event_type": "entity.created",
-  "version": "1.0",
-  "timestamp": "2026-01-23T10:00:00Z",
-  "correlation_id": "uuid",
-  "payload": {
-    "entity_id": "uuid",
-    "name": "string",
-    "created_by": "uuid"
-  }
-}
-```
-
----
-
-## Integration Architecture
-
-### External Systems
-
-| System | Type | Protocol | Data Exchanged | Frequency |
-|--------|------|----------|----------------|-----------|
-| [System 1] | Inbound | REST API | Product data | On-demand |
-| [System 2] | Outbound | Kafka | Order events | Real-time |
-| [System 3] | Sync | REST API | Inventory levels | Every 5 min |
-
-### API Contracts
-
-#### [External API 1]
-
-**Base URL:** https://external-system.com/api/v1
-**Authentication:** API Key in header
-
-| Endpoint | Method | Purpose |
-|----------|--------|---------|
-| /resources | GET | Fetch resources |
-| /resources | POST | Create resource |
-
----
-
-## Cross-Cutting Concerns
-
-### Security
-
-| Concern | Implementation |
-|---------|---------------|
-| Authentication | JWT tokens via API Gateway |
-| Authorization | Role-based (RBAC) |
-| Data Protection | TLS 1.3, AES-256 at rest |
-| Secrets | HashiCorp Vault |
-
-### Observability
-
-| Concern | Tool | Implementation |
-|---------|------|----------------|
-| Logging | Loki + zerolog | Structured JSON logs |
-| Metrics | VictoriaMetrics | Prometheus exposition |
-| Tracing | Tempo | OpenTelemetry |
-| Profiling | Pyroscope | Continuous profiling |
-
-### Error Handling
-
-| Error Type | HTTP Code | Strategy |
-|------------|-----------|----------|
-| Validation | 400 | Return structured errors |
-| Not Found | 404 | Return with message |
-| Business Rule | 422 | Return with error code |
-| Internal | 500 | Log + correlation ID |
-| External Failure | 503 | Circuit breaker + retry |
-
----
-
-## Architecture Decision Records (ADRs)
-
-### ADR-001: [Decision Title]
-
-**Status:** Accepted | Superseded | Deprecated
-**Date:** YYYY-MM-DD
-**Deciders:** [Names]
-
-**Context:**
-[Why this decision was needed - the problem or requirement]
-
-**Decision:**
-[What was decided - the chosen solution]
-
-**Consequences:**
-- **Positive:** [Benefits]
-- **Negative:** [Trade-offs]
-- **Risks:** [What could go wrong]
-
-**Alternatives Considered:**
-1. [Alternative 1] - Rejected because [reason]
-2. [Alternative 2] - Rejected because [reason]
-
----
-
-### ADR-002: [Decision Title]
-
-[Same structure...]
-
----
-
-## NFR Compliance
-
-| NFR ID | Requirement | Architectural Support |
-|--------|-------------|----------------------|
-| NFR-001 | Response time < 200ms | Caching, connection pooling |
-| NFR-002 | 99.9% availability | K8s HA, health checks |
-| NFR-003 | 1000 RPS throughput | Horizontal scaling |
-| NFR-010 | Data encryption | TLS + encryption at rest |
-
----
-
-## Deployment Architecture
-
-### Infrastructure
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                     Kubernetes Cluster                       │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │                    Namespace: prod                    │   │
-│  │  ┌────────────┐  ┌────────────┐  ┌────────────┐     │   │
-│  │  │  Service A │  │  Service B │  │  Service C │     │   │
-│  │  │  (3 pods)  │  │  (3 pods)  │  │  (2 pods)  │     │   │
-│  │  └────────────┘  └────────────┘  └────────────┘     │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │                External Services                      │   │
-│  │  PostgreSQL (RDS)    Kafka (MSK)    Redis (Elasticache)│ │
-│  └──────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Scaling Strategy
-
-| Service | Min Pods | Max Pods | Scaling Metric |
-|---------|----------|----------|----------------|
-| Service A | 3 | 10 | CPU > 70% |
-| Service B | 3 | 8 | RPS > 500 |
-
----
-
-## Risks & Technical Debt
-
-| Item | Type | Impact | Mitigation Plan | Owner |
-|------|------|--------|-----------------|-------|
-| [Item 1] | Risk | High | [Plan] | [Name] |
-| [Item 2] | Tech Debt | Medium | [Plan] | [Name] |
-
----
-
-## Diagrams
-
-### C4 - Container Diagram
-
-[Link to diagram or embedded]
-
-### Sequence Diagram - [Flow Name]
-
-```
-┌─────┐     ┌─────┐     ┌─────┐     ┌─────┐
-│Client│     │ API │     │Svc A│     │ DB  │
-└──┬──┘     └──┬──┘     └──┬──┘     └──┬──┘
-   │  request  │           │           │
-   │──────────>│           │           │
-   │           │  forward  │           │
-   │           │──────────>│           │
-   │           │           │   query   │
-   │           │           │──────────>│
-   │           │           │   result  │
-   │           │           │<──────────│
-   │           │  response │           │
-   │           │<──────────│           │
-   │  response │           │           │
-   │<──────────│           │           │
-```
-
----
-
-## References
-
-- CLAUDE.md - Coding standards and patterns
-- PRD - Product requirements
-- docs/architecture/adr/ - All ADRs
-
----
-
-## Revision History
-
-| Version | Date | Author | Changes |
-|---------|------|--------|---------|
-| 0.1 | YYYY-MM-DD | [Name] | Initial draft |
-| 1.0 | YYYY-MM-DD | [Name] | Approved |

package/src/opencode/templates/epic-template.md

@@ -1,166 +0,0 @@
-# Epic {{epic_number}}: {{epic_title}}
-
-**Epic ID:** {{module}}-E{{epic_number}}
-**Status:** TODO | IN_PROGRESS | DONE
-**Priority:** P0 | P1 | P2
-**Sprint:** sprint-{{sprint_number}}
-**Branch:** feature/epic-{{epic_number}}-{{short_name}}
-
----
-
-## Overview
-
-[2-3 sentences describing what this epic delivers and why it matters]
-
-### Business Value
-
-[Why is this epic important? What problem does it solve?]
-
-### Dependencies
-
-**Requires (must complete first):**
-- [Epic ID]: [brief reason]
-
-**Enables (unlocks these):**
-- [Epic ID]: [brief reason]
-
-### Technical Documentation (MANDATORY)
-
-**Documents used to create this epic:**
-- [ ] `CLAUDE.md` - Project patterns and conventions
-- [ ] `docs/architecture.md` - Section: [specific section]
-- [ ] `docs/architecture/{{module}}/` - Module documentation
-  - [ ] `index.md` - Module overview
-  - [ ] `architecture.md` - Module design
-  - [ ] `data-model.md` - Database schema
-  - [ ] `api/` - API contracts
-  - [ ] `events/` - Event schemas
-
-### Architecture References
-
-- [Link to architecture section that this epic implements]
-- [Link to data model section]
-- [Link to API contracts if applicable]
-
-### PRD Coverage
-
-| FR ID | Requirement | Covered |
-|-------|-------------|---------|
-| FR-XXX | [description] | [ ] |
-| FR-YYY | [description] | [ ] |
-
----
-
-## Acceptance Criteria
-
-- [ ] [High-level acceptance criterion 1]
-- [ ] [High-level acceptance criterion 2]
-- [ ] [High-level acceptance criterion 3]
-- [ ] All stories completed and reviewed
-- [ ] All tests passing
-- [ ] Documentation updated
-
----
-
-## Stories
-
-### Story Breakdown
-
-| ID | Title | Status | Priority | Est | Tasks | Deps |
-|----|-------|--------|----------|-----|-------|------|
-| {{module}}-S{{epic_number}}-01 | [Domain Layer] | TODO | P0 | M | 6 | - |
-| {{module}}-S{{epic_number}}-02 | [Use Cases] | TODO | P0 | M | 8 | S01 |
-| {{module}}-S{{epic_number}}-03 | [HTTP Handlers] | TODO | P1 | S | 5 | S02 |
-| {{module}}-S{{epic_number}}-04 | [Integration Tests] | TODO | P1 | S | 4 | S03 |
-
-### Story Dependency Graph
-
-```
-S01 ──► S02 ──► S03 ──► S04
-  │              │
-  └──────────────┘ (S03 also needs domain from S01)
-```
-
-### Story Decomposition Rules
-
-Each story MUST:
-1. Be completable (not too big, not too small)
-2. Have self-contained tasks with documentation links
-3. Have clear dependencies on other stories
-4. Map to specific Acceptance Criteria
-
-### Recommended Story Order
-
-1. **Domain Layer** - Aggregates, value objects, domain services
-2. **Repository Interfaces** - Ports (domain layer)
-3. **Use Cases** - Application layer handlers
-4. **Repository Implementations** - Infrastructure adapters
-5. **HTTP/API Handlers** - Infrastructure entry points
-6. **Events** - Domain events, Kafka publishers
-7. **Integration Tests** - End-to-end verification
-
-### Stories by Layer
-
-| Layer | Stories | Tasks | Size |
-|-------|---------|-------|------|
-| Domain | 1 | 4 | M |
-| Application | 2 | 6 | M |
-| Infrastructure | 2 | 5 | L |
-| Testing | 1 | 3 | S |
-| **Total** | **6** | **18** | |
-
-**Note:** No hour estimates. Size = relative complexity (XS/S/M/L/XL).
-
----
-
-## Technical Notes
-
-### Key Decisions
-- [Decision 1]
-- [Decision 2]
-
-### Implementation Hints
-- [Hint 1]
-- [Hint 2]
-
-### Files to Create/Modify
-- `src/path/to/file` - [description]
-- `src/path/to/another` - [description]
-
-### Testing Strategy
-- Unit tests: [approach]
-- Integration tests: [approach]
-
----
-
-## Risks & Mitigations
-
-| Risk | Impact | Probability | Mitigation |
-|------|--------|-------------|------------|
-| [Risk 1] | H/M/L | H/M/L | [How to address] |
-
----
-
-## Notes
-
-[Any additional context, links, or references]
-
----
-
-## Changelog
-
-<!-- UPDATE AT END OF SESSION -->
-
-| Version | Date | Author | Changes |
-|---------|------|--------|---------|
-| 0.1 | {{date}} | @{{author}} | Initial creation |
-
-<!-- 
-Changelog Guidelines:
-- Update at END of work session
-- Summarize all changes in one entry
-- Version: 0.x=planning, 1.0=sprint-ready, 1.x=in-progress
-
-Example:
-| 1.0 | 2024-01-15 | @sm | Add stories S01-S05; Define all AC; Ready for sprint |
--->