@schuettc/opencode-feature-workflow

Feature lifecycle management plugin for OpenCode.

Overview

This plugin provides a complete feature workflow system for managing software development projects. It automatically tracks features through their lifecycle from ideation to completion.

Installation

bun install @schuettc/opencode-feature-workflow

Add to your opencode.json:

{
  "plugin": ["@schuettc/opencode-feature-workflow"]
}

Usage

The plugin provides automatic feature workflow management based on file presence:

Feature Lifecycle

1. Capture - Create docs/features/[id]/idea.md

   • Adds feature to backlog
   • Plugin auto-generates DASHBOARD.md

2. Plan - Create docs/features/[id]/plan.md

   • Moves feature to "In Progress"
   • Updates session title
   • Shows toast notification

3. Ship - Create docs/features/[id]/shipped.md

   • Marks feature as "Completed"
   • Clears session title
   • Shows completion toast

Automatic Behaviors

The plugin automatically:

• Generates DASHBOARD.md on any feature file change
• Blocks direct writes to DASHBOARD.md (use feature commands instead)
• Updates session title when working on features
• Shows toast notifications for status changes

Skills

Load these skills using the skill tool:

• feature-capture - Add features to backlog with interactive prompts
• feature-plan - Start implementing a feature with comprehensive planning
• feature-ship - Complete a feature with quality gates
• feature-status - View project status and backlog overview
• feature-init - Initialize feature workflow structure
• feature-troubleshoot - Debug and resolve issues
• feature-audit - Audit feature implementation
• checking-backlog - Check backlog status

Agents

Invoke these agents using @mention:

• @project-manager - Requirements analysis and user stories
• @security-reviewer - Security vulnerability detection
• @qa-engineer - Test coverage and acceptance criteria
• @system-designer - High-level architecture
• @api-designer - API/GraphQL design
• @frontend-architect - React component architecture
• @integration-designer - Frontend-backend integration
• @ux-optimizer - UX optimization
• @code-archaeologist - Reverse-engineer legacy code
• @test-generator - TDD - write tests before implementation
• @documentation-agent - Documentation maintenance
• @runtime-auditor - Runtime auditing

File Structure

Features are stored in directories with status determined by file presence:

docs/features/
├── DASHBOARD.md              # Auto-generated, read-only
├── my-feature/
│   ├── idea.md               # Problem statement + metadata (backlog)
│   ├── plan.md               # Implementation plan (in-progress)
│   └── shipped.md            # Completion notes (completed)
└── another-feature/
    └── idea.md

Status Detection

| Files Present | Status | |---------------|--------| | idea.md only | backlog | | idea.md + plan.md | in-progress | | idea.md + plan.md + shipped.md | completed |

Development

# Install dependencies
bun install

# Run tests
bun test

# Run tests with coverage
bun test --coverage

# Build
bun run build

# Lint
bun run lint

# Type check
bun run typecheck

Configuration

Environment Variables

None required. The plugin uses OpenCode's built-in configuration.

Customization

To customize agent behavior, create custom agents in your .opencode/agents/ directory based on the provided templates.

Migration from Claude Code

If you're migrating from the Claude Code version of this plugin:

1. Skills - Mostly compatible, just load them differently (use skill tool instead of /command)
2. Agents - Same content, different invocation (use @mention instead of agent dispatch)
3. Hooks - Fully automatic, no manual intervention needed
4. Dashboard - Same format, auto-generated

License

MIT

Contributing

Contributions welcome! Please open an issue or pull request on GitHub.

Support

For issues and feature requests, please use the GitHub issue tracker.