md² documentation

Your first card

Ten minutes, from empty board to an agent working on a card.

1. Create a card

New card in the menu, or the + on a board column.

Pick a type (feature, job, bug), type a title, choose the column, and write a body — or keep the template and fill it in later. Press create.

On disk you now have design/active/F_1_your_title.md with a header and your body. Commit it whenever you like; md² commits it for you within the auto-commit delay.

2. Edit it

Click the card. The popup has the Markdown editor with a formatting toolbar. Everything you type is saved to the file and committed after you stop typing.

Useful things in the popup:

3. Move it

Drag the card to another column. That rewrites its status field, and the after field of a couple of neighbours to keep the order.

4. Add an action

New action in the menu opens an action editor tab. Fill in:

Field Value
Label Implement
Description Implement this feature
Type agent
Prompt Read and implement the feature described in {{card-file}}.

Type {{ in the prompt for the placeholder list. The action is saved as JSON in the actions folder and appears on your cards.

5. Run it

Press Run on the card. The action popup opens: add a sentence of run-specific instructions if you want, check the agent, model, and reasoning level, and press Run.

Output streams into the popup while the agent works. The card shows Running, and its other action entry points are disabled until the run ends.

6. Look at what happened

Where to go next