diff --git a/plugins/conductor/skills/context-driven-development/SKILL.md b/plugins/conductor/skills/context-driven-development/SKILL.md index 0b29c71..f44a1f0 100644 --- a/plugins/conductor/skills/context-driven-development/SKILL.md +++ b/plugins/conductor/skills/context-driven-development/SKILL.md @@ -1,6 +1,12 @@ --- name: context-driven-development -description: Use this skill when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md, and workflow.md files. +description: >- + Creates and maintains project context artifacts (product.md, tech-stack.md, workflow.md, tracks.md) + in a `conductor/` directory. Scaffolds new projects from scratch, extracts context from existing + codebases, validates artifact consistency before implementation, and synchronizes documents as the + project evolves. Use when setting up a project, creating or updating product docs, managing a tech + stack file, defining development workflows, tracking work units, onboarding to an existing codebase, + or running project scaffolding. version: 1.0.0 --- @@ -133,6 +139,8 @@ Update when: - Track status changes - Tracks are completed or archived +See [references/artifact-templates.md](references/artifact-templates.md) for copy-paste starter templates. + ## Context Maintenance Principles ### Keep Artifacts Synchronized diff --git a/plugins/conductor/skills/context-driven-development/references/artifact-templates.md b/plugins/conductor/skills/context-driven-development/references/artifact-templates.md new file mode 100644 index 0000000..706171d --- /dev/null +++ b/plugins/conductor/skills/context-driven-development/references/artifact-templates.md @@ -0,0 +1,154 @@ +# Artifact Templates + +Starter templates for each Conductor context artifact. Copy and fill in for new projects. + +> Contributed by [@fernandezbaptiste](https://github.com/fernandezbaptiste) ([#437](https://github.com/wshobson/agents/pull/437)) + +## product.md + +```markdown +# [Product Name] + +> One-line description of what this product does. + +## Problem + +What problem does this solve and for whom? + +## Solution + +High-level approach to solving the problem. + +## Target Users + +| Persona | Needs | Pain Points | +|---|---|---| +| Persona 1 | What they need | What frustrates them | + +## Core Features + +| Feature | Status | Description | +|---|---|---| +| Feature A | planned | What it does | +| Feature B | implemented | What it does | + +## Success Metrics + +| Metric | Target | Current | +|---|---|---| +| Metric 1 | target value | - | + +## Roadmap + +- **Phase 1**: scope +- **Phase 2**: scope +``` + +## tech-stack.md + +```markdown +# Tech Stack + +## Languages & Frameworks + +| Technology | Version | Purpose | +|---|---|---| +| Python | 3.12 | Backend API | +| React | 18.x | Frontend UI | + +## Key Dependencies + +| Package | Version | Rationale | +|---|---|---| +| FastAPI | 0.100+ | REST API framework | +| SQLAlchemy | 2.x | ORM and database access | + +## Infrastructure + +| Component | Choice | Notes | +|---|---|---| +| Hosting | AWS ECS | Production containers | +| Database | PostgreSQL 16 | Primary data store | +| CI/CD | GitHub Actions | Build and deploy | + +## Dev Tools + +| Tool | Purpose | Config | +|---|---|---| +| pytest | Testing (target: 80% coverage) | pyproject.toml | +| ruff | Linting + formatting | ruff.toml | +``` + +## workflow.md + +```markdown +# Workflow + +## Methodology + +TDD with trunk-based development. + +## Git Conventions + +- **Branch naming**: `feature/-description` +- **Commit format**: `type(scope): message` +- **PR requirements**: 1 approval, all checks green + +## Quality Gates + +| Gate | Requirement | +|---|---| +| Tests | All pass, coverage >= 80% | +| Lint | Zero errors | +| Review | At least 1 approval | +| Types | No type errors | + +## Deployment + +1. PR merged to main +2. CI runs tests + build +3. Auto-deploy to staging +4. Manual promotion to production +``` + +## tracks.md + +```markdown +# Tracks + +## Active + +| ID | Title | Status | Priority | Assignee | +|---|---|---|---|---| +| TRACK-001 | Feature name | in-progress | high | @person | + +## Completed + +| ID | Title | Completed | +|---|---|---| +| TRACK-000 | Initial setup | 2024-01-15 | +``` + +## product-guidelines.md + +```markdown +# Product Guidelines + +## Voice & Tone + +- Professional but approachable +- Direct and concise +- Technical where needed, plain language by default + +## Terminology + +| Term | Use | Don't Use | +|---|---|---| +| workspace | preferred | project, repo | +| track | preferred | ticket, issue | + +## Error Messages + +Format: `[Component] What happened. What to do next.` +Example: `[Auth] Session expired. Please sign in again.` +```