cody-vsa-specs

Spec-driven development meets Event Modeling

Generate vertical slice specs with a local prooph board Cody agent to unlock unmet accuracy and precision in agentic coding sessions.

Install

Install the agent into an existing Node.js project:

npm install --save-dev @proophboard/cody-vsa-specs

Initialize Cody agent by creating a cody.config.ts in the project root:

npx cody-vsa-specs init

Start the agent

npx cody-vsa-specs start

This will start an express server running on port 3311.

You can use another port like this:

PORT=3333 npx cody-vsa-specs start

Example & Process Overview

1. Open the Cody VSA Specs in the prooph board free client.
2. Choose Cody from the menu in the top right corner.
3. A Cody Console will open with a connect command prefilled: /connect http://localhost:3311. Press enter or adjust the port if you used a different one.
4. Navigate on the board to Todo List Example.
5. Right-click on the command (blue card) Write Todo and choose Trigger Cody from the context menu.
6. Switch to your repo and find the generated spec files in the folder chapters.

Here is a short video demonstrating the steps

Not using Node?

No problem! Cody agent writes the specs into JSON files (by default), processable any language.

Set up an empty Node.js project and install the agent. You can point it to your real project via cody.config.ts.

Alternatively, you can run it in a docker container. @TODO: Provide a docker image