foundation

Author and validate ADRs, DIRECTIVES, and USER-STORIES for AutoPilot projects.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/Kohlex/autopilot-plugin --skill foundation-kohlex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foundation
Source: https://github.com/Kohlex/autopilot-plugin/tree/main/skills/foundation
Command: npx skills add https://github.com/Kohlex/autopilot-plugin --skill foundation-kohlex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Foundation provides the upstream, peer-reviewed contract for AutoPilot capabilities, anchoring ADRs, DIRECTIVES, and USER-STORIES to prevent drift across phases.

Core Features & Use Cases

  • Prose ADRs with golden/anti-examples to codify intent.
  • Atomic DIRECTIVES with stable IDs and evaluation methods.
  • User STORIES that prove two-way coverage and traceability to directives.

Quick Start

Create and validate the Foundation bundle for a new capability, then run the /peer-review gate to ensure two-way coverage.

Frequently Asked Questions about foundation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate ADRs, directives, and user stories for project alignment?

A Foundation contract anchors ADRs, directives, and user stories to prevent drift across project phases. It provides an upstream, peer-reviewed contract ensuring formal alignment before development begins.

What is the purpose of two-way coverage in user stories and directives?

Two-way coverage ensures user stories prove traceability to directives and directives map back to user stories. This validation prevents orphaned artifacts and maintains alignment across the Foundation bundle.

How do I write atomic directives with stable IDs and evaluation methods?

You author atomic directives using templates in templates/foundation/, ensuring each has a well-formed unique ID and a mandatory evaluation method. The validator lib/foundation-validate.js enforces these structural rules.

When do I need to create a Foundation bundle for a new capability?

You need a Foundation bundle when initiating new capabilities that require formal alignment across ADRs, directives, and user stories, and when peer-review gates must validate the artifacts before proceeding.

Can I use prose ADRs with examples to codify architectural intent?

Yes, the Foundation supports prose ADRs featuring golden and anti-examples to codify architectural intent. This anchors the remaining artifacts to prevent drift across phases.

Why does directive validation fail during the peer-review gate?

Validation fails if directives lack mandatory evaluation methods, use duplicate or malformed IDs, or if two-way coverage between user stories and directives is missing. The validator enforces these structural requirements.