Koan Dev Workflow Plugin

A Claude Code plugin providing development workflow commands for planning, documentation, commits, and codebase exploration.

Installation

/plugin install github:DylanNWatt/claude-planning-plugin

Or add to your project's .claude/settings.json:

{
  "plugins": ["github:DylanNWatt/claude-planning-plugin"]
}

Commands

`/plan <feature description>`

Creates a structured feature plan in ./docs/plans. The plan includes:

Overview and context
Desired outcomes
Open questions (checkmarkable)
Task breakdown (checkmarkable)
Security considerations

Example:

/plan Add user authentication with OAuth

`/execute_plan <path to plan>`

Executes a plan file task-by-task. Reviews open questions, ensures tests pass before marking tasks complete, and updates the plan as work progresses.

Example:

/execute_plan ./docs/plans/auth-feature.md

`/update_plan`

Updates the current plan with recently learned information and marks completed tasks.

`/commit`

Bundles outstanding changes into logical commits with good messages. Also:

Checks for sensitive data before committing
Runs all server tests
Ensures TypeScript has no warnings or errors

`/examine <component>`

Thoroughly examines a component of the project, documenting:

Testing commands and best practices
Architecture layers and interfaces
Utilities (linting, compilers, etc.)

Outputs documentation to ./docs/docs/agent_docs/<layer>.

Example:

/examine server

`/docs`

Creates a plan for building Sphinx documentation covering client, server, and infrastructure.

`/update_docs`

Updates existing documentation based on recent session changes, removing outdated content.

`/devcontainer`

Creates a devcontainer configuration for VS Code and GitHub Codespaces with:

Automatic dependency setup
PostgreSQL configuration on first launch
Auto-starting frontend and backend
Hot reload for code changes

License

MIT