Wingfoil

WingFoil — the repo-native intent layer for AI-native software engineering

LLM Mart 4 views 207 listing impressions

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.

WingFoil in a terminal: init, configure an approver, add a task, submit and approve it, then show its git log

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.

Related servers

Universal MCP Server with advanced AI memory capabilities and semantic search.

30 views

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

28 views

Let Codex orchestrate external coding agents through their native harnesses.

28 views

Control plane MCP for scoped recon, triage, and bounded proofs.

27 views