Skip to content

README.md

Latest commit

 

History

History
82 lines (58 loc) · 3.49 KB

README.md

File metadata and controls

82 lines (58 loc) · 3.49 KB

syspilot

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

Four managers that orchestrate the work, and seven 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
@syspilot.setup Installs/updates syspilot in your project
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

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

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 (license required)
  • Permission to install Python 3.10+ and Python packages (sphinx, sphinx-needs)

@syspilot.setup handles all installation — your IT just needs to allow it.