[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-c2af6bf7-d27a-4398-89e4-77000e13279d":3,"$fRcNwFsx9rqAhLaAyWBzpMknsJ9IJZuKuXmuDuZ_tcoA":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"c2af6bf7-d27a-4398-89e4-77000e13279d","context-driven-development","实施和维护代码 alongside 作为管理工件的环境指南，通过结构化项目文档实现一致的 AI 交互和团队协作。","cat_life_career","mod_other","sickn33,other","---\nname: context-driven-development\ndescription: \"Guide for implementing and maintaining context as a managed artifact alongside code, enabling consistent AI interactions and team alignment through structured project documentation.\"\nrisk: unknown\nsource: community\ndate_added: '2026-02-27'\n---\n\n# Context-Driven Development\n\nGuide for implementing and maintaining context as a managed artifact alongside code, enabling consistent AI interactions and team alignment through structured project documentation.\n\n## Do not use this skill when\n\n- The task is unrelated to context-driven development\n- You need a different domain or tool outside this scope\n\n## Instructions\n\n- Clarify goals, constraints, and required inputs.\n- Apply relevant best practices and validate outcomes.\n- Provide actionable steps and verification.\n- If detailed examples are required, open `resources\u002Fimplementation-playbook.md`.\n\n## Use this skill when\n\n- Setting up new projects with Conductor\n- Understanding the relationship between context artifacts\n- Maintaining consistency across AI-assisted development sessions\n- Onboarding team members to an existing Conductor project\n- Deciding when to update context documents\n- Managing greenfield vs brownfield project contexts\n\n## Core Philosophy\n\nContext-Driven Development treats project context as a first-class artifact managed alongside code. Instead of relying on ad-hoc prompts or scattered documentation, establish a persistent, structured foundation that informs all AI interactions.\n\nKey principles:\n\n1. **Context precedes code**: Define what you're building and how before implementation\n2. **Living documentation**: Context artifacts evolve with the project\n3. **Single source of truth**: One canonical location for each type of information\n4. **AI alignment**: Consistent context produces consistent AI behavior\n\n## The Workflow\n\nFollow the **Context → Spec & Plan → Implement** workflow:\n\n1. **Context Phase**: Establish or verify project context artifacts exist and are current\n2. **Specification Phase**: Define requirements and acceptance criteria for work units\n3. **Planning Phase**: Break specifications into phased, actionable tasks\n4. **Implementation Phase**: Execute tasks following established workflow patterns\n\n## Artifact Relationships\n\n### product.md - Defines WHAT and WHY\n\nPurpose: Captures product vision, goals, target users, and business context.\n\nContents:\n\n- Product name and one-line description\n- Problem statement and solution approach\n- Target user personas\n- Core features and capabilities\n- Success metrics and KPIs\n- Product roadmap (high-level)\n\nUpdate when:\n\n- Product vision or goals change\n- New major features are planned\n- Target audience shifts\n- Business priorities evolve\n\n### product-guidelines.md - Defines HOW to Communicate\n\nPurpose: Establishes brand voice, messaging standards, and communication patterns.\n\nContents:\n\n- Brand voice and tone guidelines\n- Terminology and glossary\n- Error message conventions\n- User-facing copy standards\n- Documentation style\n\nUpdate when:\n\n- Brand guidelines change\n- New terminology is introduced\n- Communication patterns need refinement\n\n### tech-stack.md - Defines WITH WHAT\n\nPurpose: Documents technology choices, dependencies, and architectural decisions.\n\nContents:\n\n- Primary languages and frameworks\n- Key dependencies with versions\n- Infrastructure and deployment targets\n- Development tools and environment\n- Testing frameworks\n- Code quality tools\n\nUpdate when:\n\n- Adding new dependencies\n- Upgrading major versions\n- Changing infrastructure\n- Adopting new tools or patterns\n\n### workflow.md - Defines HOW to Work\n\nPurpose: Establishes development practices, quality gates, and team workflows.\n\nContents:\n\n- Development methodology (TDD, etc.)\n- Git workflow and commit conventions\n- Code review requirements\n- Testing requirements and coverage targets\n- Quality assurance gates\n- Deployment procedures\n\nUpdate when:\n\n- Team practices evolve\n- Quality standards change\n- New workflow patterns are adopted\n\n### tracks.md - Tracks WHAT'S HAPPENING\n\nPurpose: Registry of all work units with status and metadata.\n\nContents:\n\n- Active tracks with current status\n- Completed tracks with completion dates\n- Track metadata (type, priority, assignee)\n- Links to individual track directories\n\nUpdate when:\n\n- New tracks are created\n- Track status changes\n- Tracks are completed or archived\n\n## Context Maintenance Principles\n\n### Keep Artifacts Synchronized\n\nEnsure changes in one artifact reflect in related documents:\n\n- New feature in product.md → Update tech-stack.md if new dependencies needed\n- Completed track → Update product.md to reflect new capabilities\n- Workflow change → Update all affected track plans\n\n### Update tech-stack.md When Adding Dependencies\n\nBefore adding any new dependency:\n\n1. Check if existing dependencies solve the need\n2. Document the rationale for new dependencies\n3. Add version constraints\n4. Note any configuration requirements\n\n### Update product.md When Features Complete\n\nAfter completing a feature track:\n\n1. Move feature from \"planned\" to \"implemented\" in product.md\n2. Update any affected success metrics\n3. Document any scope changes from original plan\n\n### Verify Context Before Implementation\n\nBefore starting any track:\n\n1. Read all context artifacts\n2. Flag any outdated information\n3. Propose updates before proceeding\n4. Confirm context accuracy with stakeholders\n\n## Greenfield vs Brownfield Handling\n\n### Greenfield Projects (New)\n\nFor new projects:\n\n1. Run `\u002Fconductor:setup` to create all artifacts interactively\n2. Answer questions about product vision, tech preferences, and workflow\n3. Generate initial style guides for chosen languages\n4. Create empty tracks registry\n\nCharacteristics:\n\n- Full control over context structure\n- Define standards before code exists\n- Establish patterns early\n\n### Brownfield Projects (Existing)\n\nFor existing codebases:\n\n1. Run `\u002Fconductor:setup` with existing codebase detection\n2. System analyzes existing code, configs, and documentation\n3. Pre-populate artifacts based on discovered patterns\n4. Review and refine generated context\n\nCharacteristics:\n\n- Extract implicit context from existing code\n- Reconcile existing patterns with desired patterns\n- Document technical debt and modernization plans\n- Preserve working patterns while establishing standards\n\n## Benefits\n\n### Team Alignment\n\n- New team members onboard faster with explicit context\n- Consistent terminology and conventions across the team\n- Shared understanding of product goals and technical decisions\n\n### AI Consistency\n\n- AI assistants produce aligned outputs across sessions\n- Reduced need to re-explain context in each interaction\n- Predictable behavior based on documented standards\n\n### Institutional Memory\n\n- Decisions and rationale are preserved\n- Context survives team changes\n- Historical context informs future decisions\n\n### Quality Assurance\n\n- Standards are explicit and verifiable\n- Deviations from context are detectable\n- Quality gates are documented and enforceable\n\n## Directory Structure\n\n```\nconductor\u002F\n├── index.md              # Navigation hub linking all artifacts\n├── product.md            # Product vision and goals\n├── product-guidelines.md # Communication standards\n├── tech-stack.md         # Technology preferences\n├── workflow.md           # Development practices\n├── tracks.md             # Work unit registry\n├── setup_state.json      # Resumable setup state\n├── code_styleguides\u002F     # Language-specific conventions\n│   ├── python.md\n│   ├── typescript.md\n│   └── ...\n└── tracks\u002F\n    └── \u003Ctrack-id>\u002F\n        ├── spec.md\n        ├── plan.md\n        ├── metadata.json\n        └── index.md\n```\n\n## Context Lifecycle\n\n1. **Creation**: Initial setup via `\u002Fconductor:setup`\n2. **Validation**: Verify before each track\n3. **Evolution**: Update as project grows\n4. **Synchronization**: Keep artifacts aligned\n5. **Archival**: Document historical decisions\n\n## Context Validation Checklist\n\nBefore starting implementation on any track, validate context:\n\n### Product Context\n\n- [ ] product.md reflects current product vision\n- [ ] Target users are accurately described\n- [ ] Feature list is up to date\n- [ ] Success metrics are defined\n\n### Technical Context\n\n- [ ] tech-stack.md lists all current dependencies\n- [ ] Version numbers are accurate\n- [ ] Infrastructure targets are correct\n- [ ] Development tools are documented\n\n### Workflow Context\n\n- [ ] workflow.md describes current practices\n- [ ] Quality gates are defined\n- [ ] Coverage targets are specified\n- [ ] Commit conventions are documented\n\n### Track Context\n\n- [ ] tracks.md shows all active work\n- [ ] No stale or abandoned tracks\n- [ ] Dependencies between tracks are noted\n\n## Common Anti-Patterns\n\nAvoid these context management mistakes:\n\n### Stale Context\n\nProblem: Context documents become outdated and misleading.\nSolution: Update context as part of each track's completion process.\n\n### Context Sprawl\n\nProblem: Information scattered across multiple locations.\nSolution: Use the defined artifact structure; resist creating new document types.\n\n### Implicit Context\n\nProblem: Relying on knowledge not captured in artifacts.\nSolution: If you reference something repeatedly, add it to the appropriate artifact.\n\n### Context Hoarding\n\nProblem: One person maintains context without team input.\nSolution: Review context artifacts in pull requests; make updates collaborative.\n\n### Over-Specification\n\nProblem: Context becomes so detailed it's impossible to maintain.\nSolution: Keep artifacts focused on decisions that affect AI behavior and team alignment.\n\n## Integration with Development Tools\n\n### IDE Integration\n\nConfigure your IDE to display context files prominently:\n\n- Pin conductor\u002Fproduct.md for quick reference\n- Add tech-stack.md to project notes\n- Create snippets for common patterns from style guides\n\n### Git Hooks\n\nConsider pre-commit hooks that:\n\n- Warn when dependencies change without tech-stack.md update\n- Remind to update product.md when feature branches merge\n- Validate context artifact syntax\n\n### CI\u002FCD Integration\n\nInclude context validation in pipelines:\n\n- Check tech-stack.md matches actual dependencies\n- Verify links in context documents resolve\n- Ensure tracks.md status matches git branch state\n\n## Session Continuity\n\nConductor supports multi-session development through context persistence:\n\n### Starting a New Session\n\n1. Read index.md to orient yourself\n2. Check tracks.md for active work\n3. Review relevant track's plan.md for current task\n4. Verify context artifacts are current\n\n### Ending a Session\n\n1. Update plan.md with current progress\n2. Note any blockers or decisions made\n3. Commit in-progress work with clear status\n4. Update tracks.md if status changed\n\n### Handling Interruptions\n\nIf interrupted mid-task:\n\n1. Mark task as `[~]` with note about stopping point\n2. Commit work-in-progress to feature branch\n3. Document any uncommitted decisions in plan.md\n\n## Best Practices\n\n1. **Read context first**: Always read relevant artifacts before starting work\n2. **Small updates**: Make incremental context changes, not massive rewrites\n3. **Link decisions**: Reference context when making implementation choices\n4. **Version context**: Commit context changes alongside code changes\n5. **Review context**: Include context artifact reviews in code reviews\n6. **Validate regularly**: Run context validation checklist before major work\n7. **Communicate changes**: Notify team when context artifacts change significantly\n8. **Preserve history**: Use git to track context evolution over time\n9. **Question staleness**: If context feels wrong, investigate and update\n10. **Keep it actionable**: Every context item should inform a decision or behavior\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,240,1965,"2026-05-16 13:13:00",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"其他","other","mdi-page-next-outline","其他类型Skill",5,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"职场发展","career","mdi-briefcase-outline","面试准备、简历优化、职业规划",4,575,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"7d78d794-9999-4f11-9207-a8a84548bebf","1.0.0","context-driven-development.zip",4693,"uploads\u002Fskills\u002Fc2af6bf7-d27a-4398-89e4-77000e13279d\u002Fcontext-driven-development.zip","23704fd651c3da84abddc5815f028baaba118f2b0236f6b89b3f19481d7b423a","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":12195}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]