DIXI Spec Kit documentation Español · Source on GitHub

Start here: your first feature

Purpose

Take one small feature from an empty folder to a verified build, one step per page, so that you learn the order of DIXI's steps by doing them. Each step says what you do, what you should see and what comes next, and links to the reference of every command it uses.

What you will build

A command-line tool that keeps short notes with tags, the same example as the command guide. The repository has a finished version of it in examples/notes: open it whenever you want to compare your result.

Before you start

AdapterAgentHow you run an operation
--agent claudeClaude Code/dixi.specify add a note with tags
--agent codexCodex CLI$dixi-specify add a note with tags
--agent skillsOpenCode, and other agents that read Agent Skills (not verified)@dixi-specify add a note with tags
--agent noneAny agent or editordixi workflow prepare prints the procedure, and you give it to your agent

Steps

  1. Install the kit: install dixi and check its version.
  2. Create the project: the documentary baseline and the agent's commands.
  3. Specify the feature: a story and numbered acceptance criteria with an ID.
  4. Plan it: the contract, the test plan and the decisions to validate.
  5. Split it into tasks: small tasks linked to the criteria they cover.
  6. Build one task: failing tests first, then the code, then make verify.
  7. Verify the feature: every criterion mapped to the test that covers it.

It takes about an hour with an agent. You can stop after any step and resume later: /dixi.status says where you left off.