context-driven-development

Overview

What is context-driven-development?

context-driven-development is a skill designed to help developers and teams create, maintain, and synchronize key project context artifacts. These include files like product.md, tech-stack.md, workflow.md, and tracks.md, all organized within a conductor/ directory. By treating project context as a first-class artifact, this skill ensures that documentation, workflows, and tech stack information remain consistent and actionable throughout the project lifecycle.

Who should use this skill?

This skill is ideal for developers, project managers, and teams who want to:

• Scaffold new projects with clear, structured documentation
• Extract and organize context from existing codebases
• Maintain up-to-date context for AI-assisted development
• Onboard new team members efficiently
• Keep project documentation synchronized as requirements and code evolve

Problems it solves

• Reduces confusion by centralizing essential project information
• Streamlines onboarding and collaboration
• Ensures documentation evolves alongside code
• Supports consistent, context-aware AI interactions

How to Use

Installation Steps

1. Install the skill using the following command:

   npx skills add https://github.com/wshobson/agents --skill context-driven-development

2. After installation, navigate to the conductor/ directory in your project to find or create context artifacts.

Getting Started

• Begin with the SKILL.md file for a high-level guide to context-driven-development principles and workflow.
• Review README.md, AGENTS.md, and metadata.json for additional project context.
• Explore the references/ folder, especially artifact-templates.md, for ready-to-use templates for each context artifact.

Adapting to Your Workflow

• Use the provided templates to scaffold new projects or extract context from existing ones.
• Regularly update context files as your project evolves to keep documentation and workflows aligned.
• Validate artifact consistency before major implementation changes to avoid misalignment.

Key Files and Folders

• SKILL.md: Main guide and workflow overview
• references/artifact-templates.md: Starter templates for all core artifacts
• conductor/: Directory for all context artifacts
• rules/, resources/, scripts/: Supporting files for advanced workflows

FAQ

When should I use context-driven-development?

Use this skill when setting up a new project, onboarding to an existing codebase, or whenever you need to update or validate project documentation, tech stack, or workflows. It's especially useful for teams adopting AI-assisted development or aiming for consistent project context.

What are context artifacts?

Context artifacts are structured documents—like product.md and tech-stack.md—that capture essential information about your project. They help keep everyone aligned and support automated tools.

Can I use this skill with existing projects?

Yes. context-driven-development can extract and organize context from existing codebases, making it suitable for both greenfield and brownfield projects.

Where can I find templates for context artifacts?

Check the references/artifact-templates.md file for starter templates you can copy and customize for your project needs.

How do I keep context artifacts up to date?

Treat context files as living documentation. Update them as your project requirements, tech stack, or workflows change. Regular reviews and validation are recommended.

Where do I find more details?

Browse the Files tab in the repository to explore the full file tree, including nested references and helper scripts for advanced usage.