specweave 0.1.8 → 0.3.0

package/src/commands/increment.md

@@ -1,223 +0,0 @@
----
-name: create-increment
-description: Create a new SpecWeave increment interactively with spec.md and tasks.md
----
-
-# Create New Increment
-
-You are helping the user create a new SpecWeave increment.
-
-## Steps:
-
-1. **Find next increment number**:
-   - Scan `.specweave/increments/` directory
-   - Find highest number (e.g., 002)
-   - Next increment: 003
-
-2. **Detect tech stack** (CRITICAL - framework-agnostic):
-   - Check `.specweave/config.yaml` for tech_stack configuration
-   - If not found, detect from project files:
-     - `package.json` → TypeScript/JavaScript
-     - `requirements.txt` or `pyproject.toml` → Python
-     - `go.mod` → Go
-     - `Cargo.toml` → Rust
-     - `pom.xml` or `build.gradle` → Java
-     - `*.csproj` → C#/.NET
-   - Detect framework (NextJS, Django, FastAPI, Spring Boot, etc.)
-   - If detection fails, ask user: "What language/framework are you using?"
-   - Store detected tech stack for later use
-
-3. **Ask user for details**:
-   - "What would you like to build?" (get high-level description)
-   - "What's the short name?" (e.g., "user-authentication" for increment 003-user-authentication)
-   - "Priority? (P1/P2/P3)" (default: P1)
-
-4. **Activate role-orchestrator**:
-   - Analyze user's description
-   - Determine which strategic agents are needed:
-     - pm-agent (product strategy)?
-     - architect-agent (system design)?
-     - devops-agent (infrastructure)?
-     - security-agent (security review)?
-     - qa-lead-agent (testing strategy)?
-
-5. **Ask clarifying questions** (if needed):
-   - Target users/scale?
-   - Technology preferences? (if not detected)
-   - Budget constraints?
-   - Deployment platform?
-   - Payment processing needed?
-   - Authentication method?
-
-6. **Run strategic agents** (with user approval):
-   - **Pass detected tech stack to ALL agents** (CRITICAL!)
-   - PM agent creates pm-analysis.md
-   - Architect agent creates architecture.md, ADRs (using detected tech stack)
-   - DevOps agent creates infrastructure.md (platform-specific)
-   - Security agent creates security.md (framework-specific security)
-   - QA agent creates test-strategy.md (framework-specific tests)
-
-7. **Present strategic docs for review**:
-   - Show summary of all strategic outputs
-   - Ask: "Review docs with /review-docs or approve to continue?"
-   - Wait for user approval
-
-8. **Create spec.md** (based on strategic docs):
-   - Frontmatter with increment number, title, priority, status, dependencies
-   - **Include detected tech stack in frontmatter** (see format below)
-   - Overview section
-   - Business value
-   - User stories with acceptance tests
-   - Functional requirements
-   - Out of scope
-   - Success criteria
-   - Dependencies
-
-9. **Create tasks.md** (task-builder skill):
-   - Analyze all strategic docs
-   - Break down into phases (framework-specific)
-   - Create tasks with:
-     - Agent references (use framework-specific agents if available)
-     - File paths (framework-specific paths: src/ for TS, app/ for Django, etc.)
-     - Implementation snippets (framework-specific code)
-     - Acceptance criteria
-     - Documentation updates
-
-10. **Save increment**:
-    - Create `.specweave/increments/####-name/`
-    - Save spec.md
-    - Save tasks.md
-    - Save strategic docs (pm-analysis.md, architecture.md, etc.)
-
-11. **Output to user**:
-    ```
-    ✅ Created increment 0003-user-authentication
-
-       Detected tech stack:
-       - Language: {detected-language} (e.g., Python, TypeScript, Go, Java)
-       - Framework: {detected-framework} (e.g., Django, FastAPI, NextJS, Spring Boot)
-       - Database: {specified-database} (e.g., PostgreSQL, MySQL, MongoDB)
-       - Platform: {specified-platform} (e.g., AWS, Hetzner, Vercel, self-hosted)
-
-       Location: .specweave/increments/0003-user-authentication/
-
-       📋 Files created:
-       - spec.md (6 user stories, 15 requirements)
-       - tasks.md (42 implementation tasks using {framework} patterns)
-       - pm-analysis.md (product strategy)
-       - architecture.md (system design for {framework})
-       - infrastructure.md ({platform} deployment)
-       - security.md ({framework}-specific security)
-       - test-strategy.md (E2E tests for {framework})
-
-       ⏱️  Estimated effort: 3-4 weeks
-
-       Next steps:
-       1. Review docs: /review-docs
-       2. Start implementation: Begin with Task T001 in tasks.md
-       3. Sync to GitHub: /sync-github
-    ```
-
-## Frontmatter Format (spec.md):
-
-**IMPORTANT**: Tech stack is DETECTED from `.specweave/config.yaml` or project files, NOT hardcoded!
-
-```yaml
----
-increment: 003-user-authentication
-title: "User Authentication System"
-priority: P1
-status: planned
-created: 2025-10-26
-dependencies: []
-structure: user-stories
-
-# Tech stack is DETECTED, not hardcoded
-tech_stack:
-  detected_from: ".specweave/config.yaml"  # or "package.json", "requirements.txt", etc.
-  language: "{detected-language}"          # e.g., "typescript", "python", "go", "java", "rust"
-  framework: "{detected-framework}"        # e.g., "nextjs", "django", "fastapi", "spring-boot", "gin"
-  database: "{specified-database}"         # e.g., "postgresql", "mysql", "mongodb", "sqlite"
-  orm: "{detected-orm}"                    # e.g., "prisma", "django-orm", "sqlalchemy", "hibernate"
-
-# Platform is SPECIFIED by user or detected from config
-platform: "{specified-platform}"           # e.g., "hetzner", "aws", "vercel", "self-hosted"
-estimated_cost: "{calculated-based-on-platform}"
----
-```
-
-**Example for TypeScript/NextJS project**:
-```yaml
-tech_stack:
-  detected_from: "package.json"
-  language: "typescript"
-  framework: "nextjs"
-  database: "postgresql"
-  orm: "prisma"
-platform: "vercel"
-estimated_cost: "$20/month"
-```
-
-**Example for Python/Django project**:
-```yaml
-tech_stack:
-  detected_from: "requirements.txt"
-  language: "python"
-  framework: "django"
-  database: "postgresql"
-  orm: "django-orm"
-platform: "hetzner"
-estimated_cost: "$12/month"
-```
-
-**Example for Go/Gin project**:
-```yaml
-tech_stack:
-  detected_from: "go.mod"
-  language: "go"
-  framework: "gin"
-  database: "postgresql"
-  orm: "gorm"
-platform: "aws"
-estimated_cost: "$25/month"
-```
-
-## Frontmatter Format (tasks.md):
-
-```yaml
----
-increment: 003-event-booking-saas
-status: planned
-dependencies:
-  - 001-skills-framework
-  - 002-role-based-agents
-phases:
-  - infrastructure
-  - backend
-  - frontend
-  - testing
-  - deployment
-estimated_tasks: 42
-estimated_weeks: 3-4
----
-```
-
-## Autonomous Mode (Advanced):
-
-If user says "autonomous mode" or "full automation":
-1. Run all strategic agents
-2. Create increment
-3. **Start implementation immediately** (with permission)
-4. Ask clarification questions only when critical
-5. Suggest doc updates when needed
-6. Complete full implementation autonomously
-
-## Error Handling:
-
-- If `.specweave/` not found: "Error: Not a SpecWeave project. Run /create-project first."
-- If user description too vague: Ask more clarifying questions
-- If strategic agents not available: "Warning: Some agents missing. Continue with basic spec?"
-
----
-
-**Important**: This is the main entry point for creating new work in SpecWeave.

package/src/commands/review-docs.md

@@ -1,331 +0,0 @@
----
-name: review-docs
-description: Review strategic documentation before implementation (PM analysis, architecture, ADRs, infrastructure, security, testing)
----
-
-# Review Strategic Documentation
-
-You are presenting strategic documentation for user review before implementation begins.
-
-## Steps:
-
-1. **Detect current increment**:
-   - Look for most recent or in-progress increment in `.specweave/increments/`
-   - Or ask: "Which increment would you like to review? (001, 002, 003, etc.)"
-
-2. **Read all strategic documentation**:
-   - spec.md (user stories, requirements)
-   - pm-analysis.md (if exists)
-   - architecture.md, ADRs in `.specweave/docs/architecture/`, `.specweave/docs/decisions/`
-   - infrastructure.md (if exists)
-   - security.md (if exists)
-   - test-strategy.md (if exists)
-
-3. **Present comprehensive summary**:
-
-## Review Format:
-
-```
-═══════════════════════════════════════════════════════
-📋 Strategic Documentation Review
-═══════════════════════════════════════════════════════
-
-Increment: 003-event-booking-saas
-Title: Event Booking SaaS Platform
-Priority: P1
-Status: Planned
-
-───────────────────────────────────────────────────────
-✅ PRODUCT STRATEGY (pm-analysis.md)
-───────────────────────────────────────────────────────
-
-User Personas:
-  1. Barber Shop Owner (primary)
-     - Needs: Easy booking management, reduce no-shows
-     - Pain points: Manual scheduling, phone tag
-
-  2. Customer (secondary)
-     - Needs: Quick booking, reminders
-     - Pain points: Calling during business hours
-
-Business Model:
-  - Revenue: Subscription ($29/month per business)
-  - Alternative: 3% commission per booking
-  - Target: 100 businesses in Year 1 ($34k ARR)
-
-Feature Prioritization:
-  P1 (MVP):
-    - Booking calendar
-    - SMS/Email notifications
-    - Payment processing
-
-  P2 (Post-launch):
-    - Recurring bookings
-    - Multiple staff members
-    - Analytics dashboard
-
-Success Metrics:
-  - Bookings per business: 50+/month
-  - No-show reduction: 30%
-  - Customer satisfaction: 4.5+/5
-
-───────────────────────────────────────────────────────
-✅ SYSTEM ARCHITECTURE (architecture.md)
-───────────────────────────────────────────────────────
-
-**IMPORTANT**: Architecture adapts to YOUR detected tech stack!
-
-Tech Stack (detected from .specweave/config.yaml or project files):
-  Frontend: {detected-frontend}  (e.g., NextJS, React, Vue, Angular, Svelte)
-  Backend: {detected-backend}    (e.g., Django, FastAPI, Express, Spring Boot, Gin)
-  Database: {specified-database} (e.g., PostgreSQL, MySQL, MongoDB, SQLite)
-  ORM: {detected-orm}            (e.g., Prisma, Django ORM, SQLAlchemy, Hibernate, GORM)
-  UI: {specified-ui}             (e.g., Tailwind, Material UI, Bootstrap, Chakra)
-  Auth: {specified-auth}         (e.g., NextAuth, Django Auth, Passport, JWT, Auth0)
-  Payments: {specified-payments} (e.g., Stripe, PayPal, Square)
-
-System Design:
-  [Mermaid diagram showing architecture using YOUR framework]
-
-  Example for TypeScript/NextJS:
-    User → NextJS (SSR) → API Routes → Prisma → PostgreSQL
-
-  Example for Python/Django:
-    User → Django (Templates) → Views → Django ORM → PostgreSQL
-
-  Example for Go/Gin:
-    User → Gin API → Handlers → GORM → PostgreSQL
-
-  (Architecture diagram adapts to YOUR detected stack)
-
-Data Models:
-  - User (auth, profile)
-  - Business (shop details)
-  - Service (haircut, massage, etc.)
-  - Booking (appointment)
-  - Payment (transaction)
-
-API Design:
-  - POST /api/bookings/create
-  - GET /api/bookings/:id
-  - PUT /api/bookings/:id/cancel
-  - GET /api/availability
-
-Scalability:
-  - Handles 10,000 users
-  - 1,000 concurrent bookings/day
-  - Redis caching for availability queries
-  - Database indexing on booking_date, business_id
-
-───────────────────────────────────────────────────────
-✅ ARCHITECTURE DECISIONS (ADRs)
-───────────────────────────────────────────────────────
-
-**ADRs are framework-specific and adapt to YOUR project**
-
-Example ADRs for TypeScript/NextJS project:
-  ADR 001: NextJS over separate React + API
-    - Reason: Simplified deployment, SSR benefits
-    - Trade-off: Less separation of concerns
-
-Example ADRs for Python/Django project:
-  ADR 001: Django monolith over microservices
-    - Reason: Faster development, easier deployment for MVP
-    - Trade-off: Harder to scale individual components
-
-Example ADRs for Go/Gin project:
-  ADR 001: Gin over Echo
-    - Reason: Better performance, larger community
-    - Trade-off: Less built-in middleware
-
-Platform Decision (adapts to user preference):
-  ADR 00X: {Platform} over {Alternative}
-    - Reason: Cost, performance, or developer familiarity
-    - Examples: Hetzner ($12/mo), Vercel ($20/mo), AWS ($25/mo), self-hosted
-
-Database Decision (adapts to use case):
-  ADR 00X: {Database} over {Alternative}
-    - Reason: ACID compliance, scaling needs, or data structure
-    - Examples: PostgreSQL (relational), MongoDB (document), Redis (cache)
-
-───────────────────────────────────────────────────────
-✅ INFRASTRUCTURE (infrastructure.md)
-───────────────────────────────────────────────────────
-
-**Infrastructure adapts to chosen platform**
-
-Platform: {detected-platform} (e.g., Hetzner, AWS, Vercel, self-hosted)
-
-Example for Hetzner Cloud:
-  Resources:
-    - CX21 instance (2 vCPU, 4GB RAM): $6.90/month
-    - Managed Postgres (2GB): $5.00/month
-    - Total: ~$12/month
-
-Example for AWS:
-  Resources:
-    - t3.small EC2 (2 vCPU, 2GB RAM): $15/month
-    - RDS PostgreSQL (db.t3.micro): $12/month
-    - Total: ~$27/month
-
-Example for Vercel:
-  Resources:
-    - Hobby tier (for small projects): $20/month
-    - Pro tier (for production): $20/month
-    - Database (Neon/PlanetScale): $0-10/month
-
-Deployment:
-  - Docker containers
-  - GitHub Actions CI/CD
-  - Blue-green deployment
-  - Automated backups (daily)
-
-Monitoring:
-  - Uptime Kuma (self-hosted)
-  - Error tracking: Sentry (free tier)
-  - Analytics: Plausible (self-hosted)
-
-DNS & SSL:
-  - Cloudflare (free tier)
-  - Let's Encrypt (auto-renewal)
-
-───────────────────────────────────────────────────────
-✅ SECURITY (security.md)
-───────────────────────────────────────────────────────
-
-**Security strategy adapts to YOUR framework**
-
-Authentication (framework-specific):
-  - TypeScript/NextJS: NextAuth.js with credentials + OAuth
-  - Python/Django: Django Auth with Allauth
-  - Go/Gin: JWT tokens with middleware
-  - Java/Spring: Spring Security with OAuth2
-
-  Providers: Google, GitHub, Email magic links (framework-agnostic)
-  Session management: JWT or session cookies (framework-dependent)
-
-Authorization (framework-specific):
-  - TypeScript/Prisma: Row-level security in PostgreSQL
-  - Python/Django: Django permissions + object-level permissions
-  - Go/GORM: Middleware-based access control
-  - Java/Spring: Spring Security annotations
-
-  Business logic:
-    - Businesses can only access their own data
-    - Customers can only see their own bookings
-
-Data Protection (framework-agnostic):
-  - GDPR compliant
-  - Data encryption at rest (database-level)
-  - HTTPS only (enforced)
-  - PII data: minimal collection
-
-Payment Security (framework-agnostic):
-  - Stripe (PCI-DSS compliant)
-  - No card data stored locally
-  - Webhook signature verification (framework-specific implementation)
-
-───────────────────────────────────────────────────────
-✅ TEST STRATEGY (test-strategy.md)
-───────────────────────────────────────────────────────
-
-Test Pyramid:
-  E2E Tests (10%): Playwright
-    - Complete booking flow
-    - Payment flow
-    - Cancellation flow
-
-  Integration Tests (30%): Jest + Testing Library
-    - API endpoints
-    - Database queries
-    - External service mocks (Stripe, Vonage)
-
-  Unit Tests (60%): Jest
-    - Business logic
-    - Utilities
-    - Validation functions
-
-Coverage Target: 80%
-
-Critical Paths (E2E):
-  1. Business signup → Create service → Receive booking
-  2. Customer booking → Payment → Confirmation
-  3. Cancellation → Refund
-
-Performance Tests:
-  - 100 concurrent bookings
-  - Response time <200ms (p95)
-  - Database query optimization
-
-───────────────────────────────────────────────────────
-💰 COST ESTIMATE
-───────────────────────────────────────────────────────
-
-Infrastructure: $12/month
-External Services:
-  - Stripe: 2.9% + $0.30 per transaction
-  - Resend: $20/month (10k emails)
-  - Vonage: $10/month (~2k SMS)
-
-Total Monthly: $42/month (at 100 businesses)
-
-Revenue: $2,900/month (100 businesses * $29)
-Profit: $2,858/month (98% margin)
-
-───────────────────────────────────────────────────────
-⏱️  IMPLEMENTATION ESTIMATE
-───────────────────────────────────────────────────────
-
-Total Tasks: 42
-Estimated Time: 3-4 weeks (1 developer)
-
-Phases:
-  Week 1: Infrastructure + Backend (Tasks T001-T020)
-  Week 2: Frontend (Tasks T021-T035)
-  Week 3: Testing (Tasks T036-T040)
-  Week 4: Deployment + Polish (Tasks T041-T042)
-
-═══════════════════════════════════════════════════════
-
-Do you approve this plan?
-
-Options:
-  ✅ "approve" - Start creating tasks.md
-  ⚠️  "changes needed" - Request specific updates
-  📋 "questions" - Ask clarifying questions
-  🔄 "regenerate" - Regenerate strategic analysis
-
-───────────────────────────────────────────────────────
-```
-
-## After User Approval:
-
-If user approves:
-```
-✅ Strategic documentation approved
-
-   Next steps:
-   1. Creating tasks.md with task-builder skill...
-   2. Breaking down into 42 implementation tasks...
-   3. Estimated completion: [date]
-
-   Once tasks.md is ready:
-   - Type "start implementation" to begin Task T001
-   - Or review tasks first with: cat .specweave/increments/0003-event-booking-saas/tasks.md
-```
-
-If user requests changes:
-```
-What would you like to change?
-  1. Architecture (tech stack, design)
-  2. Infrastructure (platform, cost)
-  3. Features (scope, priorities)
-  4. Security approach
-  5. Other
-```
-
-Then run appropriate agents again and re-present.
-
----
-
-**Important**: This command is critical for ensuring user approval before starting costly implementation work.

package/src/commands/sync-github.md

@@ -1,115 +0,0 @@
----
-name: sync-github
-description: Sync SpecWeave increment to GitHub issues with checkable subtasks
----
-
-# Sync Increment to GitHub
-
-You are syncing a SpecWeave increment to GitHub issues.
-
-## Steps:
-
-1. **Detect current increment** or ask user which to sync:
-   - Look in `.specweave/increments/` for most recent or in-progress increment
-   - Or ask: "Which increment would you like to sync? (001, 002, etc.)"
-
-2. **Read increment files**:
-   - spec.md (user stories, acceptance tests)
-   - tasks.md (implementation tasks)
-   - Optional: pm-analysis.md, architecture.md, etc.
-
-3. **Use github-sync skill** to:
-   - Create GitHub issue with title: `[Increment ###] [Title]`
-   - Add overview from spec.md
-   - Add user stories as checkable subtasks (GitHub task list)
-   - Add tasks as nested checklist
-   - Add labels: `specweave`, `priority:P1/P2/P3`, `status:planned/in-progress/completed`
-   - Add links back to `.specweave/increments/` files
-
-4. **Store GitHub issue number**:
-   - Update increment frontmatter with `github_issue: #123`
-   - This enables bidirectional sync
-
-## GitHub Issue Format:
-
-```markdown
-# [Increment ###] Title
-
-## Overview
-[From spec.md]
-
-## Business Value
-[From spec.md if exists]
-
-## User Stories
-
-- [ ] **US1**: [Title] (P1)
-  - Acceptance test 1
-  - Acceptance test 2
-- [ ] **US2**: [Title] (P2)
-  - Acceptance test 1
-
-## Implementation Tasks
-
-### Phase 1: [Phase Name]
-- [ ] **T001**: [Task description]
-- [ ] **T002**: [Task description]
-
-### Phase 2: [Phase Name]
-- [ ] **T010**: [Task description]
-
-## Documentation
-
-- [Specification](.specweave/increments/####-name/spec.md)
-- [Tasks](.specweave/increments/####-name/tasks.md)
-- [Architecture](.specweave/docs/architecture/) (if applicable)
-
-## Dependencies
-
-- Depends on: #[issue-number] (if applicable)
-
-## Success Criteria
-
-[From spec.md]
-
----
-*Created by SpecWeave - [Learn more](https://github.com/specweave/specweave)*
-```
-
-## Output to User:
-
-After syncing, tell user:
-
-```
-✅ Synced increment 002-role-based-agents to GitHub
-
-   Issue: #15
-   URL: https://github.com/[user]/[repo]/issues/15
-
-   📋 Contains:
-   - 6 user stories
-   - 17 tasks
-   - Links to all documentation
-
-   The issue will automatically update when you mark tasks complete.
-
-   To update manually: /sync-github
-```
-
-## Bidirectional Sync
-
-If the increment already has `github_issue` in frontmatter:
-- Update existing issue instead of creating new one
-- Sync status changes (completed tasks, etc.)
-- Add comment with updates
-
-## Error Handling
-
-- If not in a git repository: "Error: Not a git repository. Initialize git first."
-- If no GitHub credentials: "Error: GitHub credentials not configured. Set GITHUB_TOKEN."
-- If increment not found: "Error: Increment not found. Use /create-increment first."
-
----
-
-**Important**: This command requires the `github-sync` skill to be installed.
-If not found, suggest: `npx specweave install github-sync`

package/src/skills/ado-sync/test-cases/test-1.yaml

@@ -1,9 +0,0 @@
----
-name: "Detect ADO Sync Request"
-description: "Tests if ado-sync skill activates for Azure DevOps sync"
-input:
-  prompt: "Sync increment 0001 to Azure DevOps"
-expected_output:
-  skill_activated: true
-  agent_invoked: "specweave-ado-mapper"
----

package/src/skills/ado-sync/test-cases/test-2.yaml

@@ -1,8 +0,0 @@
----
-name: "Ask for Area Path"
-description: "Tests if ado-sync asks for Area Path when exporting"
-input:
-  prompt: "Export to ADO"
-expected_output:
-  area_path_prompt: true
----

package/src/skills/ado-sync/test-cases/test-3.yaml

@@ -1,9 +0,0 @@
----
-name: "Handle ADO API Errors"
-description: "Tests error handling for ADO authentication failures"
-input:
-  prompt: "Sync to ADO"
-  ado_configured: false
-expected_output:
-  error: "ADO PAT not configured"
----