---
name: Project Cairn
slug: project-cairn
category: AI Engineering
description: Project Cairn turns project work into reusable knowledge by keeping validated lessons, decisions, and notes in project files. Use it to initialize or maintain Cairn docs, audit drift, cite external knowledge, and prepare reusable experience for graduation.
github: "https://github.com/iBlinkQ/project-cairn"
language: Shell
stars: 223
forks: 44
install: "npx degit https://github.com/iBlinkQ/project-cairn ~/.claude/skills/project-cairn"
installs_to: ~/.claude/skills/project-cairn
source_path: SKILL.md
collection_size: 1
category_size: 2970
added: 2026-09-04T05:24:50.260Z
last_synced: 2026-09-04T05:24:50.260Z
canonical_url: "https://dirskills.com/skills/project-cairn"
---

# Project Cairn

Project Cairn turns project work into reusable knowledge by keeping validated lessons, decisions, and notes in project files. Use it to initialize or maintain Cairn docs, audit drift, cite external knowledge, and prepare reusable experience for graduation.

**Install:**

```bash
npx degit https://github.com/iBlinkQ/project-cairn ~/.claude/skills/project-cairn
```

## README

# Project Cairn

Project Cairn gives AI-collaboration projects a durable way to keep and reuse what they learn while doing real work. The **Skill** supplies the method, **AGENTS.md** carries always-read project rules, and **`.cairn/config.yaml`** stores machine-readable configuration.

This Skill is documentation-first. It provides instructions, templates, references, and provider adapters. It has no CLI, MCP server, background hook, chat-end trigger, automatic provider write, or automatic history migration. Routine maintenance happens during normal work because `AGENTS.md` carries the rules. Provider writes require human confirmation.

## Routing

Load exactly the reference you need:

- `references/init.md` — initialize, retrofit, bootstrap, or set up Project Cairn in a project.
- `references/consume.md` — pull, cite, reuse, or apply external knowledge from the configured knowledge base.
- `references/maintenance.md` — record progress, update LOG, update ROADMAP, maintain topic notes, or apply Cairn rules after work.
- `references/audit.md` — inspect, audit, validate, clean up, or find missing project knowledge records.
- `references/upgrade.md` — upgrade an initialized project instance to the current skill spec, or check how far it has drifted (instance drift after the skill itself evolved).
- `references/graduation.md` — graduate knowledge, move reusable experience to a knowledge base, or judge graduation-readiness; a provider write additionally reads only the selected `references/graduation/<provider>.md`.
- `references/frontmatter.md` — create or review Cairn topic notes or knowledge-base notes.
- `references/branch-closure.md` — review, close, abandon, or roll back an exploration branch and salvage its `cairn/` knowledge before it disappears.
- `references/zh-glossary.md` — writing project docs in Chinese (or resolving what a Chinese term should be); fixed English↔Chinese terminology mapping for Project Cairn's own vocabulary.

Frontmatter describes triggers, not workflow.

## Templates

`assets/templates/` contains `AGENTS.md`, `CLAUDE.md`, `config.yaml`, `user-config.yaml`, `LOG.md`, `ROADMAP.md`, `topic.md`, and `Cited.md`. `init` scaffolds `AGENTS.md`, `CLAUDE.md`, `.cairn/config.yaml`, `cairn/LOG.md`, and optional `cairn/ROADMAP.md`; it can seed optional `~/.config/cairn/config.yaml` from `user-config.yaml`. `topic.md`, `Cited.md`, and `Reference/` are trigger-created. Templates use `{{PLACEHOLDER}}` tokens; never hardcode a provider or knowledge path.

## Boundaries

- No background hook and no chat-end trigger are assumed.
- Day-to-day maintenance happens because `AGENTS.md` is read as project rules.
- Audit is the safety net for missed records.
- Graduation is candidate detection plus human confirmation.
- Historical migration is optional and separate from init.
- `scripts/*.sh` use bash (verified on macOS/Linux; Windows needs WSL or Git Bash). `scripts/*.py` use Python 3 without a shell; `notion-graduate-batch.py` also needs PyYAML.