Documentation skill

Project memory

Updated

Generate project instruction files that transfer institutional knowledge, not obvious information.

Works in: Uses the open Agent Skills format. Codex: adapter required; runtime fixtures pending.

When to use

What's included

Deletion test

Guidelines for cutting obvious information. If an experienced journalist already knows it, delete it.

6 project templates

Editorial tools, event websites, publications, research projects, content pipelines, and digital archives.

Voice guidelines

Direct, terse notes. No marketing language. No "Welcome to..." introductions.

Good vs. bad examples

Side-by-side comparisons of verbose documentation vs. institutional knowledge only.

Pinned repository ledger

A reference for one pinned issue per repository that holds live status, active holds, and a message board when several agents or people share the work.

What belongs in a project instruction file

Include Don't include
Project-specific quirks How journalism works generally
YOUR naming conventions Standard file organization
Commands with YOUR flags Generic commands like "npm install"
Non-obvious architecture Framework documentation
Common mistakes in THIS project General best practices

Choose the right mechanism

MechanismUse for
Project instruction fileStanding facts, commands, conventions, and boundaries
SkillFact-check workflows, FOIA-letter drafting, and other multi-step procedures
Client enforcementRules that must block or run every time, such as a Claude Code hook that exits 2. Prompt hooks only remind.

Client-specific locations

Claude Code

/etc/claude-code/CLAUDE.md or the documented macOS and Windows managed-policy paths; ./CLAUDE.md or ./.claude/CLAUDE.md; ~/.claude/CLAUDE.md; and gitignored ./CLAUDE.local.md.

Codex

~/.codex/AGENTS.md, then AGENTS.md files from the repository root through the working directory. AGENTS.override.md replaces the file at the same scope.

Memory and institutional knowledge

In Claude Code v2.1.59 and later, auto memory stores corrections under ~/.claude/projects/<project>/memory/. Do not ask users to copy those notes into shared project instructions.

# Project instructions

## Gotchas
- Story slugs must be unique across all desks, not only metro.
- "Hold" does not stop the autopublish cron. Use "Kill."
- The reporter dropdown caches for one hour.

## Commands
npm run sync-ap  # Pull latest from AP. Runs automatically at :15.

## Credentials
The Supabase key is in the 1Password "Metro Desk" vault, not .env.

Template selector

Tool

editorial-tool.md

Newsroom tools, fact-checkers, AI assistants

Event

event-website.md

Conferences, workshops, campaign sites

Content

publication.md

Newsletters, podcasts, ongoing content series

Research

research-project.md

Investigations, data journalism with defined scope

Pipeline

content-pipeline.md

CMS workflows, publishing automation

Archive

digital-archive.md

Historical collections, document repositories

Length guideline

Treat 200 lines as a review threshold, not a target. If the file grows, move procedures to skills, narrow rules to nested instruction files, and transient notes to client memory.

The best project instruction files capture quirks that caused real mistakes.

Sources: Claude Code memory, Claude Code best practices, and official Codex AGENTS.md guidance. Claude sources last swept May 9, 2026; Codex scoping checked Oct. 23, 2026.

Installation

# Recommended: install the project-templates-toolkit plugin

/plugin marketplace add jamditis/claude-skills-journalism

/plugin install project-templates-toolkit@claude-skills-journalism

# Or copy just this skill from the plugin tree

git clone https://github.com/jamditis/claude-skills-journalism.git

mkdir -p ~/.claude/skills ~/.agents/skills

cp -r claude-skills-journalism/project-templates-toolkit/skills/project-memory ~/.claude/skills/ # Claude Code

cp -r claude-skills-journalism/project-templates-toolkit/skills/project-memory ~/.agents/skills/ # Codex

Or browse this skill in the GitHub repository.

Related skills

Document what matters

Templates for institutional knowledge, not generic documentation.

View on GitHub