Plaintext Local Agile Notes & Kanban
A file-system-native project management standard for Git repositories. Any repo that follows this spec can be read, written, and automated by humans, CLI tools, and AI agents — without external services.
→ PLANK.md — the minimal shared contract → PLANK_BLACK.md — the opinionated strict superset
Add .plank/issues/ to your repo root and create your first issue:
mkdir -p .plank/issues---
id: PROJ-001
title: Your first task
status: todo
priority: medium
created: 2026-02-26
updated: 2026-02-26
---
# Your first task
## Description
.../plugin marketplace add allen2c/PLANK
/plugin install plank@plank-marketplace
This gives you two skills:
| Skill | Command | Description |
|---|---|---|
| PLANK | /plank:plank |
Manage issues using the minimal PLANK standard |
| PLANK BLACK | /plank:plank-black |
Enforce the strict PLANK BLACK workflow |
Fetch the spec before operating on any PLANK-compliant repo:
GET https://raw.githubusercontent.com/allen2c/PLANK/main/PLANK.md
If the project follows PLANK BLACK, also fetch:
GET https://raw.githubusercontent.com/allen2c/PLANK/main/PLANK_BLACK.md
CC0 — copy, fork, adapt freely.