Skip to content
← Back

Phase 1 of 6 · Before any code is written

Specify

  1. Pick up the issue

    pmkit (project management kit) is an issue tracker for AI. It connects your agent with your tickets (Jira, Linear, GitHub Issues etc).

    Start with /pmkit:issues:work <id>, it claims the issue, creates its branch and reads its context, scope and acceptance criteria.

    Result: the agent starts from what the issue asks for, not from a guess.

  2. Question the idea

    The agent interviews you one question at a time and checks each answer against the requirements. Factual questions are answered from the code instead of being asked.

    Result: no open question left about what to build.

  3. Record terms and decisions

    During the interview, a new term or a hard-to-reverse decision is written down as soon as it settles.

    Result: each new term is in the GLOSSARY.md and each decision is an ADR file.

  4. Write and approve the design

    The agent writes the design doc from the answers and you review it. Nothing is planned until you approve it.

    Result: an approved design doc, the input of the Plan phase.