context-driven-development skill (wshobson) for Claude Code: project context
Makes Claude keep project context in files: product.md, tech-stack.md, workflow.md and tracks.md in a conductor/ folder.
- Installs
- 11.3K
- on skills.sh
- Stars
- 42.1K
- on GitHub
- Files
- 2
- besides SKILL.md
- Updated
- Oct 2026
- last repo commit
context-driven-development is a skill from wshobson/agents, part of the conductor plugin. Its description says it creates and maintains project context files in a conductor/ directory, extracts context from an existing codebase, checks the files agree before implementation and keeps them in sync as the project changes.
The files are product.md, product-guidelines.md, tech-stack.md, workflow.md and tracks.md. references/details.md covers how they relate, greenfield and brownfield projects, anti-patterns and session handoffs. references/artifact-templates.md has starter templates. The skill is guidance, and the conductor plugin adds six command files for the workflow itself.
Good for
- Developers who repeat the same project background in every session
- Teams onboarding people or agents to an existing codebase
- Anyone tracking units of work as tracks in their repo
Install context-driven-development
Claude Code
- 1
Copy this prompt.
Install the context-driven-development skill in Claude Code. Run this command: npx skills add wshobson/agents --skill context-driven-development Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Pick one route. The plugin routes install the whole conductor plugin: 3 skills, 1 agent file(s) and 6 command file(s), counted from the plugin folder in the repo tree, which has no hooks or MCP config files. The skills-only routes install just this skill, with no agents or commands. The /conductor:setup command that references/details.md tells you to run is one of the plugin's command files, so use a plugin route if you want that workflow.
Built from the package data we hold. Not yet tested by us. Source.
What's in the skill
When it loads
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.
Sections in SKILL.md
- When to Use This Skill
- Detailed patterns and worked examples
- Best Practices
Key facts
- Author
- Seth Hobson (wshobson)
- Repository
- wshobson/agents
- Installs on skills.sh
- 11,319 (Nov 2, 2026)
- GitHub stars (repo)
- 42,081 (Nov 2, 2026)
- Last repo commit
- Oct 30, 2026
What it includes
Defines what the product is and why. Template in artifact-templates.md.
The skill has Claude create and update this file under conductor/ in your project.
Files ·
product.mdRecords languages, key dependencies, infrastructure and dev tools.
Files ·
tech-stack.mdRecords methodology, git conventions, quality gates and deployment.
Files ·
workflow.mdLists active and completed units of work.
Files ·
tracks.mdRecords voice and tone, terminology and error message style.
Files ·
product-guidelines.mdNew projects and existing codebases both start with /conductor:setup, a plugin command.
references/details.md says setup asks questions for a new project and analyzes the existing code, configs and docs for a brownfield one.
Read ·
Greenfield vs brownfieldChecks product, technical, workflow and track context before implementing.
Context validation checklistHow to start, end and resume a session so context carries over.
Session continuityRead context first, make small updates, commit context with code.
Best practices (10)
From the official docs
Questions
How do I install the context-driven-development skill?
Use the install box above. The skills CLI command installs only this skill. The plugin route installs conductor, which holds 3 skills, 1 agent file(s) and 6 command file(s) in the repo.
Do I need the conductor plugin?
For the setup workflow, yes. references/details.md tells you to run /conductor:setup for both new and existing projects, and that command lives in the plugin's commands folder (setup.md), not in the skill folder. The conductor plugin holds this skill, two other skills, one agent file and six command files (setup, new-track, implement, status, manage, revert). The skill folder alone carries the guidance and the templates in references/artifact-templates.md.
What does it write to my project?
Per its description, it creates and maintains context artifacts in a conductor/ directory: product.md, tech-stack.md, workflow.md and tracks.md. Commit them with your code, as SKILL.md recommends.
Is context-driven-development safe to install?
The folder holds three Markdown files and no scripts. It does make Claude write files into your repo, so review the conductor/ files in version control. The details file also suggests pre-commit hooks and CI checks, which you would set up yourself.
Which license does it use?
The conductor plugin manifest says Apache-2.0. The crawl of the repo lists MIT. Check the repo before you reuse the text.
Does context-driven-development work in the Claude app or Codex?
The install box lists a zip upload for the Claude app and a plugin route for Codex. The wshobson/agents README names Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi as supported tools.
Information
updated Nov 2, 2026
- Repository
- wshobson/agents
- Folder
plugins/conductor/skills/context-driven-development
Sources
Docs, issue trackers and discussions this page is built from.
Show all 11Hide
- wshobson/agents README · github.com
- Marketplace manifest · github.com
- Claude Code skills · code.claude.com
- Using skills in Claude · support.claude.com
- context-driven-development SKILL.md · github.com
- references/details.md · github.com
- references/artifact-templates.md · github.com
- skills.sh listing · skills.sh
- Repository · github.com
- conductor plugin folder · github.com
- conductor plugin.json · github.com