Software Factory
Best practices

Agent Skill

Install and use the Software Factory agent skill to execute work orders consistently.

Agent skills are modular bundles of instructions, scripts, and resources that an agent can load at runtime to perform specific tasks with the right procedures and context.

The Software Factory agent skill gives agents the information they need to use the platform effectively and execute Work Orders consistently. This only works once you've connected to Software Factory with MCP.

Connect MCP before installing the skill

The skill provides the workflow, while MCP provides access to your Software Factory project. Complete the MCP connection first so the agent can read requirements, blueprints, and work orders.

Install and use the skill

Install the skill

Run:

npx skills add 8090-inc/software-factory-plugin

Invoke the skill

In Cursor, invoke it explicitly with /software-factory. For other agents, reference Software Factory, a requirement, a blueprint, or a work order in your prompt. The agent loads the related process and context when needed.

Execute a work order

Give the agent a work order number or link and ask it to use the Software Factory skill to execute it. The skill guides the agent through reading related requirements and blueprints, planning, implementation, and verification.

Execution state

When execution starts, the agent creates scratch/wo-execution/WO-<number>/. It stores execution state in implementation-plan.md, checklist.md, context.md, and verification-log.md while the work order is completed.

The directory gives the agent a consistent place to track what it has read, what it plans to change, what it changed, what it reviewed, and how it verified the work. This makes the work order easier to resume, inspect, and review after the implementation is done.

On this page