dev:plan

Installation
SKILL.md

Compatibility: If AskUserQuestion is unavailable, present options as a numbered list and wait for the user's reply. If Task is unavailable, run parallel steps sequentially. The context: fork and agent: frontmatter fields are Claude Code-specific — on OpenCode and VS Code Copilot they are ignored and the skill runs inline using the current model.

Plan software architecture for a project or feature. Writes drafts to .codevoyant/plans/.

Step 0: Parse Args

Extract:

  • FEATURE_NAME = first non-flag argument (slugify for filename)
  • PLAN_MODE = value after --mode (arch or feat); if absent, leave unset — Step 1 will ask
  • BG_MODE, SILENT as standard

If no FEATURE_NAME: ask "What are we designing architecture for?" (free text).

Derive:

  • FEATURE_SLUG = lowercase, hyphens (e.g. "auth refresh flow" → "auth-refresh-flow")
  • PLAN_DIR = .codevoyant/plans/{FEATURE_SLUG}

Create output directory:

Related skills

More from cloudvoyant/codevoyant

Installs
14
First Seen
Mar 21, 2026