Getting Started

Prerequisites

VS Code with the GitHub Copilot extension enabled
Node.js (≥ 18) for validation scripts

Installation

1. Clone the repository

git clone https://github.com/SebastienDegodez/skraft-plugin.git
cd skraft-plugin

2. Install the agent package manager (optional)

If you use external plugins, install apm — Agent Package Manager:

# macOS / Linux
curl -sSL https://aka.ms/apm-unix | sh
# Windows: irm https://aka.ms/apm-windows | iex

# then, from the repo root (apm reads apm.yml):
apm install

3. Open in VS Code

Agents are auto-discovered from the .github/agents/ directory. No additional configuration is needed.

4. First run

Type /skraft in Copilot Chat to launch the orchestrator. It automatically detects the project state and resumes from the last persisted phase.

5. Follow the DISCOVER → DELIVER flow

Assign yourself a GitHub issue, then let the orchestrator guide you through the six phases:

DISCOVER — Triage and prioritization
DISCUSS — Refinement into user stories
DESIGN — Architecture and ADRs
DISTILL — BDD scenarios
DELIVER — TDD implementation

Each phase is validated by a dedicated reviewer before moving to the next.

→ See the phase details for more information.