AI Dev Workflow Kit

A reusable set of AI development agent templates that adapts to your project. They are templates, not project-ready agents.

Quick start · How it works · What's inside · Agents · Adapt a project

Start here: clone the kit, open your project, run ADAPT_PROJECT.md, and answer a few questions.

How it works

flowchart LR
    A[Your project] --> C[Inspect]
    B[AI Dev Workflow Kit] --> C
    C --> D[Ask]
    D --> E[Confirm]
    E --> F[Generate]
    F --> G[Project-specific agent system]

Loading

The AI reads the repository, asks only what it cannot safely determine, confirms the current project model, and then generates the adapted system.

The AI does not invent missing product logic.

Quick start

1. Clone the kit.

   git clone https://github.com/Lugovele/ai-dev-workflow-kit.git

2. Open your project in your AI coding environment.

3. Give the AI access to this kit:

   AGENTS.template.md
   agents/
   contracts/
   adaptation/ADAPT_PROJECT.md
   

4. Run adaptation/ADAPT_PROJECT.md.

5. Answer the questions.

6. Confirm the proposed setup.

7. Start development.

What's inside

File	Purpose
AGENTS.template.md	Base repository-level AI development rules
agents/	Reusable agent templates
contracts/	Shared reviewer and lifecycle contracts
ADAPT_PROJECT.md	Project adaptation prompt

The result is a project-specific AGENTS.md and the smallest useful set of adapted agents.

Not every project needs every agent.

New or early-stage projects

The project does not need to be fully defined before adaptation.

Status	Meaning
CONFIRMED	Already decided
PROVISIONAL	May still change
OPEN	Not decided yet

Open questions are not turned into permanent project rules.

As the project evolves, run the adaptation prompt again. The agent system should evolve with the project.

Development flow

flowchart LR
    A[Task] --> B{Specialist review?}
    B -->|If needed| C[Review]
    B -->|No| D[Implement]
    C --> D
    D --> E[Test]
    E --> F[Change review]
    F --> G{Findings?}
    G -->|Yes| H[Remediate]
    H --> I[Same reviewer re-checks]
    I --> F
    G -->|No| J[Approved]
    J --> K[Commit]
    K --> L[Push]

Loading

Specialist review runs only when needed. Remediation returns to the same originating reviewer. Approval comes before commit and push.

Commit and push may be automated after the configured review lifecycle passes.

Branches and worktrees should only be created when they are actually useful.

One rule to remember

Don't copy and rename the agents. Adapt them.

Start adapting your project