Convention files for AI agents working on Simple and Fast projects.
1. Overview
Agent conventions are markdown files that define coding standards, git
workflows, testing guidelines, and agent behavior rules. They are installed
as plain files and consumed by pi coding agent via AGENTS.md loading.
2. Building
nix build .#agent-conventionsThe output contains convention files at $out/ and $out/conventions/.
3. Included files
| File | Description |
AGENTS.md | Main agent behavior guidelines |
conventions/coding-standards.md | Language-specific code style and conventions |
conventions/git-workflow.md | Git procedures and practices |
conventions/testing.md | Testing guidelines |
conventions/README.md | Overview of conventions |
4. Usage
The Docker image includes agent-conventions so that pi coding agent can
load AGENTS.md from the workspace. Agents read these files at startup to
understand project conventions.
5. Source
pkgs/agent-conventions/default.nix — installs markdown files from the
skills-src git input using stdenv.mkDerivation.