@syntesseraai/opencode-feature-factory

OpenCode plugin that provides Feature Factory agents for structured software development workflows.

Installation

$3

Add the plugin to your opencode.json:

``json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@syntesseraai/opencode-feature-factory"]
}
`

$3

To install Feature Factory agents, skills, and MCP servers globally, run:

`bash
npx @syntesseraai/opencode-feature-factory install
`

This will:

- Copy agents to ~/.config/opencode/agents/
- Copy skills to ~/.config/opencode/skills/
- Configure MCP servers in ~/.config/opencode/opencode.json

Agents Provided

$3

- @ff-plan - Creates detailed implementation plans based on GitHub issues. Read-only, no code changes.
- @ff-build - Implements features based on plans. Full tool access with bash permission guards.

$3

- @ff-mini-plan - Quick 2-5 step plans for smaller tasks. Escalates to @ff-plan for complex work.
- @ff-review - Code review for correctness, quality, and test coverage.
- @ff-security - Deep security audits (auth, injection, secrets, OWASP Top 10).
- @ff-unit-test - Generates comprehensive unit tests with 80%+ coverage target.
- @ff-e2e-test - Creates end-to-end tests for user workflows (Playwright/Cypress).
- @ff-acceptance - Binary pass/fail validation against acceptance criteria.
- @ff-well-architected - Reviews code against AWS Well-Architected Framework pillars.

Behavior

- Manual install: Agents and skills are installed via the npx install command, not automatically
- Never overwrites: If an agent or skill file already exists, it is never overwritten. This respects any user customizations.
- Global install: Agents and skills are installed to ~/.config/opencode/ for use across all projects

Agent Scope Boundaries

Each agent has a focused responsibility and delegates to specialists:

| Agent | Focus | Delegates to |
| --------------------- | --------------------------- | -------------------------------------------------------- |
| ff-plan | Deep planning, architecture | - |
| ff-build | Implementation | All subagents |
| ff-mini-plan | Quick plans (2-5 steps) | @ff-plan for complex |
| ff-review | Quality, correctness, tests | @ff-security, @ff-well-architected, @ff-acceptance |
| ff-security | Security only | - |
| ff-unit-test | Unit tests only | - |
| ff-e2e-test | E2E tests only | - |
| ff-acceptance | Requirements validation | - |
| ff-well-architected | AWS pillars | @ff-security for deep security |

Customization

After installation, you can edit any ff-*.md file in .opencode/agent/ to customize behavior. The plugin will never overwrite your changes.

To reset an agent to defaults, delete the file and restart OpenCode.

Output Formats

All agents output structured JSON for consistent parsing:

- Planning agents: { summary, steps[], files[], complexity, ... }
- Review/audit agents: { approved, confidence, findings[], recommendations[], ... }
- Acceptance: { accepted, criteriaMet[], criteriaNotMet[], ... }`

License

MIT