This project is predicate — a system for portable, composable agent configuration.
Important
You must review PREDICATE.md and follow its protocol before beginning work.
Active Personas: None
This is a documentation-only repository. The language-specific personas (go.md, rust.md, etc.) are provided as templates for other projects, but are not active here. The integral.md axiom guides meta-project reasoning.
Note
This repository is the Predicate source. The axioms/, personas/, and workflows/ directories live at the repo root — not under .agent/ — because this is the upstream that other projects consume via submodule or symlink. When mounted into a consuming project, these directories appear under .agent/ as described in PREDICATE.md.
Predicate is a framework for configuring AI coding agents with reusable rulesets (axioms), composable extensions (personas), and task-specific procedures (workflows).
Purpose: Replace ad-hoc system prompts with version-controlled, shareable agent configuration.
| Directory | Purpose |
|---|---|
axioms/ |
Foundational rulesets (axioms) |
personas/ |
Context-specific extensions |
workflows/ |
Manually-triggered SOPs |
templates/ |
Project templates (AGENTS.md) |
docs/ |
Guides, plans, and ADRs, formalisms |
This is a documentation-only repository. No build required.
- Validate markdown:
markdownlint .(if installed) - Check links:
markdown-link-check *.md(if installed)
- Markdown: Follow GitHub Flavored Markdown
- Tables: Align columns for readability
- Lists: Use
-for unordered lists - Headers: Use
##sections with---separators
See README.md for contribution guidelines.
When adding content:
- New axioms →
axioms/ - New personas →
personas/ - New workflows →
workflows/with proper front-matter
Pre-1.0: Breaking changes expected. Design over stability.