EPURE (Giskard-AI/epure)
E.P.U.R.E.
- EN: Engineered Planning, Unified Review & Execution
- FR: Élaboration de Plans, Usinage, Revue et Exécution
(In French architecture, l'épure is the full-scale geometrical working drawing traced before cutting stone or timber—from the /epure plan Grill interview to the versioned specification, dependency-ordered ticket DAG, secretless TDD sandbox, and multi-agent review.)
Open-source framework of GitHub Actions Reusable Workflows, TypeScript Custom Actions (Node.js 24 LTS), and AI Agent Skills that orchestrates the complete specification-driven software engineering lifecycle on consumer repositories with deterministic guarantees, secretless sandboxing, Impeccable UI gates, and sovereign human validation gates on GitHub.
Quickstart: Bootstrap a Repository with the /setup-repo Skill
The preferred way to onboard a new or existing repository is to invoke the /setup-repo skill (.agents/skills/setup-repo/SKILL.md) inside any Skills-compatible coding agent:
/setup-repo <owner>/<repo>
The agent inspects your repository's stack and domain modules, guides you through creating the 2 GitHub Apps and environment-scoped secrets (setup-github-apps-wizard.sh --repo <owner>/<repo> --llm-env <env-name>), runs dist/cli/setup-repo.mjs --dry-run before --apply --apply-github-settings (5 Repository Rulesets + squash-only governance), and dynamically designs your multi-agent reviewer roster (.agents/reviewers/*.md by default, configurable with --reviewers-dir) tailored to your codebase.
Official Bilingual Documentation (English & Français)
The official documentation (powered by VitePress and interactive Archify showcase diagrams) is live at https://giskard-ai.github.io/epure/ (EN) and https://giskard-ai.github.io/epure/fr/ (FR):
- AI & LLM Index (
llms.txt standard):
Local Documentation & Diagram Commands
# Validate and render all 12 bilingual Archify diagrams (showcase quality)
npm run docs:diagrams
# Start the local VitePress documentation server
npm run docs:dev
# Build the production static documentation site
npm run docs:build
Domain Model, ADRs & Specifications
GLOSSARY.md — Canonical Ubiquitous Language dictionary (Q1–Q111, ADR-0029–ADR-0033).DESIGN.md — Impeccable design system tokens, WCAG 2.1 AA contrast ratios, and <ArchifyDiagram> interaction states.docs/DECISIONS.md — Complete architectural decision log across 24 Grill rounds (Q1–Q103).docs/CONTRACTS.md — Public reusable workflow and custom action contracts.docs/adr/ — 33 Architecture Decision Records (ADRs) tracing every structural decision.docs/specs/dev-automation-v1.md — Complete V1 functional and technical specification.
Upstream Attributions & Credits
Full license notices and pinned provenance hashes are tracked in NOTICE and skills-lock.json (ADR-0018):
| Upstream Project | License | Role in EPURE |
|---|
Matt Pocock Agent Skills (mattpocock/skills) | MIT | Specification-driven planning, domain modeling, TDD, and review skills (grill-with-docs, to-spec, to-tickets, tdd, code-review, domain-modeling, prototype, wizard, pr with credit to Dex Horthy / HumanLayer). |
Impeccable (pbakaus/impeccable) | Apache-2.0 | UX/UI design system workflow (shape, DESIGN.md, .impeccable/surfaces/*.md) and WCAG 2.1 AA quality gate (actions/impeccable, impeccable-gate). |
Archify (tt-a1i/archify) | MIT | Interactive showcase architecture diagrams embedded in scripts/archify/. |
iFixAi (ifixai-ai/iFixAi) | Apache-2.0 | Deterministic authorization trajectory auditing (actions/ifixai). |
zizmor (woodruffw/zizmor) | MIT | Static security analysis for GitHub Actions workflows (actions/zizmor-audit). |
Renovate (renovatebot/renovate) | AGPL-3.0 (Tool) | Automated updates of SHA-pinned workflows and dependencies (auto_migrate). |
