Wingfoil
WingFoil — the repo-native intent layer for AI-native software engineering
A structured harness for AI-assisted software development, built to make it deterministic.
WingFoil solves a critical problem: as your software project grows, AI agents lose consistency and control. Context gets scattered, conventions drift, and decisions made in one session don't carry forward to the next.
WingFoil centralizes your project's memory, DNA, and directives in a structured, git-backed format — giving both humans and AI agents a shared source of truth.

The first example, docs/examples/01-first-project, recorded from
docs/examples/01-first-project/demo.tape. The example checks its own
results, and the recording stops if a check fails, so if WingFoil stops matching the example the recording fails
instead of going stale.
The Problem
When using AI agents to write software, you face growing friction:
- Context collapse: Large context windows and full codebase scans become expensive and noisy
- Convention drift: Agents don't respect established patterns unless you re-explain them every session
- Decision scatter: Architectural decisions, patterns, and constraints live in Slack, old docs, or nowhere
- Governance gaps: No way to enforce rules consistently across human developers and AI agents
The larger the project, the worse the signal-to-noise ratio.
The Solution
WingFoil provides a structured, authoritative interface to your project:
- Project Memory — Git-backed storage for decisions, artifacts, and domain knowledge
- Project DNA — Structural map of modules, tech stack, and conventions
- Project Directives — Role-based rules that both humans and agents respect
- Workflow State Management — Unified tracking and communication of project flow, progress, and blockers
- Interaction Layer — CLI for humans, MCP for agents
This keeps everything synchronized, so that two runs from the same specs and configuration can produce equivalent software: the goal the Determinism Index measures (see Success Metric below).
Who It's For
Alex, the Solo Developer
Every new AI session forces you to re-explain context. WingFoil loads relevant info in seconds — no more context loss
between sessions.
Sam, the Code Reviewer
You're starting with AI for code review but aren't confident enough for full development yet. WingFoil lets you enforce
quality standards and gradually expand AI usage as you gain confidence.
Jordan, the Team Developer
You don't know what conventions your tech lead has defined, and agents ignore team rules. WingFoil keeps everyone
aligned on directives, decisions, and project state without constant manual updates.
Morgan, the Tech Lead
You need agents to follow the team's rules automatically, not invent new ones. WingFoil encodes governance once; it
auto-loads for every agent. It also keeps the whole team synchronized on progress and blockers.
Casey, the Manager
You need visibility into decisions and methodology. WingFoil provides an audit trail, queryable knowledge base, and
real-time tracking of project state.
Key Features
Five Pillars — status in 0.3
From the project's README.