plank

PLANK

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.

The Spec

→ PLANK.md — the minimal shared contract → PLANK_BLACK.md — the opinionated strict superset

Quick Start

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
...

Install as Claude Code Plugin

/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

For AI Agents

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.