Requirements Engineering that scales with AI.

Your project has 5000 requirements. A change affects 5 of them. syspilot follows sphinx-needs traceability links to find exactly those 5 — so your AI agent gets focused context, not the entire codebase.

Cover 100% of your specs with 6x less tokens. Links are deterministic — search is probabilistic. syspilot gives your agents the map, not the flashlight. Built on sphinx-needs by useblocks. Powered by GitHub Copilot.

Quick Start

Linux / Mac / GitHub Codespaces:

mkdir -p .github/agents && curl -fsSL \
  "https://raw.githubusercontent.com/enthali/syspilot/main/syspilot/agents/syspilot.setup.agent.md" \
  -o .github/agents/syspilot.setup.agent.md

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path .github/agents | Out-Null
Invoke-WebRequest `
  -Uri "https://raw.githubusercontent.com/enthali/syspilot/main/syspilot/agents/syspilot.setup.agent.md" `
  -OutFile ".github/agents/syspilot.setup.agent.md"

Then open VS Code Copilot Chat and run @syspilot.setup.

That's it. The setup agent handles dependencies, configuration, and validation automatically.

What You Get

Three managers that orchestrate the work, and eight engineers that execute it:

Managers	What they do
@syspilot.pm	Plans features, manages backlog, delegates change requests
@syspilot.cm	Orchestrates engineers through the change workflow
@syspilot.qm	Runs independent quality checks

Engineers	What they do
@syspilot.design	Analyzes a change request, creates a Change Document
@syspilot.implement	Executes approved changes with traceability
@syspilot.uat	Generates user acceptance test artifacts
@syspilot.verify	Validates implementation against the Change Document
@syspilot.docu	Keeps project documentation current
@syspilot.mece	Finds gaps and redundancies in your specs
@syspilot.trace	Traces one item through all levels
@syspilot.release	Manages versioning and release process
@syspilot.setup	Installs/updates syspilot in your project

Agents are stable processes (WHAT to do). Skills are exchangeable tool bindings (HOW to do it) — customize syspilot by swapping skills, not agents.

How It Works

User Story (WHY)  ──links──▶  Requirements (WHAT)  ──links──▶  Design Specs (HOW)

When you request a change, syspilot follows these links to find only the affected elements. O(affected), not O(total).

Documentation

📖 Full docs: enthali.github.io/syspilot

Includes methodology, naming conventions, and traceability matrices.

Requirements

• VS Code + GitHub Copilot
• Python 3.10+

License

Apache 2.0