agentleFS
LwhieldonLwhieldon/claude-project-mgmt-playbook/CLAUDE.md

claude-project-mgmt-playbook

CLAUDE.md4 starsChanged 33 days agoMITView on GitHub

This file gives Claude persistent context about who we are, how we work, and the standards that apply to every task in this project. Edit the [PLACEHOLDER] fields before your first session. Keep it under 200 lines; move reference material into a skill. All client-facing content must be: Internal working documents may be more direct and less formal. When tone is not specified, default to professional consulting style: confident, concise, recommendation-forward. These lines hold on a busy day because they…

The file

Show its rules and text

We split this CLAUDE.md into the rules it gives an agent

14 rules. About 0 are common, 10 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    All client-facing content must be:

    line 22
  2. Distinctive:

    Professional and precise: no filler phrases, no hedging without substance behind it

    line 24
  3. Distinctive:

    Action-oriented: every recommendation names an owner and a deadline

    line 26
  4. Distinctive:

    When tone is not specified, default to professional consulting style: confident, concise, recommendation-forward.

    line 31
  5. Distinctive:

    Treat all PII, financial figures, and proprietary process details as confidential.

    line 38
  6. Distinctive:

    When in doubt, describe the data structure rather than sharing the data itself.

    line 39
  7. Distinctive:

    Do not include client names or identifying details in commit messages.

    line 41
  8. Distinctive:

    Never name one client in another client's deliverable.

    line 42
  9. Very specific:

    Never invents a number, an owner, or a date: Use [TBD] or [NEEDS INPUT].

    line 51
  10. Very specific:

    Action items: Always include: Action, Owner, Due Date, Priority (High/Med/Low)

    line 75
  11. Distinctive:

    Tables: Use Markdown tables; they paste cleanly into Word and most PM tools

    line 78
  12. Very specific:

    Provenance: Every client-facing draft ends with Drafted with Claude Code on YYYY-MM-DD.

    line 79
  13. Very specific:

    Subagent: ask for "a second look" or "fresh eyes" on a file and Claude delegates to the second-reviewer agent in .claude/agents/, which …

    line 101
  14. Distinctive:

    Add running notes here as the engagement progresses.

    line 107

≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
CLAUDE.md

Project Leadership: Claude Code Context

This file gives Claude persistent context about who we are, how we work, and the standards that apply to every task in this project. Edit the [PLACEHOLDER] fields before your first session. Keep it under 200 lines; move reference material into a skill.


Firm & Practice Context

  • Firm: [YOUR FIRM NAME]
  • Practice: [e.g., Enterprise Advisory & Transformation]
  • Engagement type: [e.g., ERP implementation / Data modernization / Process transformation]
  • Client: [CLIENT NAME]: [one-liner: industry, company size, what they do]
  • Engagement phase: [e.g., Discovery / Design / Build / UAT / Hypercare]
  • Engagement lead: [Your name and title]
  • Key client contacts: [Name, Title; Name, Title]
  • Contract value / duration: [e.g., $850K / 12 months ending Dec 2026]

Communication Standards

All client-facing content must be:

  • Professional and precise: no filler phrases, no hedging without substance behind it
  • Audience-appropriate: executive summaries at the C-suite level; working docs for the delivery team
  • Action-oriented: every recommendation names an owner and a deadline
  • Formatted for reuse: headers, bullets, and tables so output drops into PowerPoint or Word with minimal editing

Internal working documents may be more direct and less formal.

When tone is not specified, default to professional consulting style: confident, concise, recommendation-forward.


Confidentiality Rules

  • Reference client files by path; never paste raw client data into the prompt. Claude reads the file directly.
  • Treat all PII, financial figures, and proprietary process details as confidential.
  • When in doubt, describe the data structure rather than sharing the data itself.
  • Real engagement files live in my-projects/, which is gitignored. Session-specific sensitive notes go in CLAUDE.local.md, also gitignored.
  • Do not include client names or identifying details in commit messages.
  • Never name one client in another client's deliverable.

What Claude Does Not Do Here

These lines hold on a busy day because they are written down, not because anyone remembers them.

  • Never sends. Email, chat messages, anything outbound: drafts only. A person presses send.
  • Never invents a number, an owner, or a date. Use [TBD] or [NEEDS INPUT]. A blank is fixable in ten seconds; an invented figure that reached a client is not.
  • Never settles a RAG rating. Propose it with the reasoning. The delivery lead confirms or overrules.
  • Never treats memory as a source. Anything recalled from an earlier session is a hint about where to look. Re-read the file before writing a fact from it.

See docs/keep-leadership-human.md for the two questions behind these rules.


Common Artifact Types

ArtifactPurposeKey Sections
Statement of Work (SOW)Defines scope, timeline, costScope, Deliverables, Assumptions, Pricing, Change Control
Status ReportWeekly engagement health updateRAG status, Accomplishments, Milestones, Risks/Issues, Actions
Change RequestDocuments scope changes formallyDescription, Impact (scope/time/cost), Approvals required
Executive SummaryCompresses a document for senior audienceSituation, Key findings, Recommendations, Next steps
Meeting SummaryCaptures decisions and actions from a meetingAttendees, Decisions, Action items (owner + due date)
Risk RegisterTracks project risks over timeRisk, Likelihood, Impact, Mitigation, Owner, Status

Default Output Formats

  • Status: RAG indicators (🔴 Red / 🟡 Amber / 🟢 Green) for overall status and each workstream. Those three words only; no "yellow," "at risk," or "on track" as a status value.
  • Action items: Always include: Action, Owner, Due Date, Priority (High/Med/Low)
  • PowerPoint-ready content: Short bullets (12 words or fewer), no nesting deeper than 2 levels
  • Word/email content: Full sentences, structured headers, professional closing
  • Tables: Use Markdown tables; they paste cleanly into Word and most PM tools
  • Provenance: Every client-facing draft ends with Drafted with Claude Code on YYYY-MM-DD; reviewed by [NAME]. The reviewer fills in their name before it goes out. A draft with the placeholder still in it has not been reviewed.

Skills

Skills live in .claude/skills/. Type / to browse them, or describe the task in plain language and Claude picks the matching skill.

SkillWhat it does
/status-reportWeekly status report from a CSV or free-text summary
/status-commsSame status story as an email, slide bullets, or dashboard narrative
/transcript-actionsAction items, decisions, and risks from a meeting transcript
/meeting-prepFull briefing package for a client or internal meeting
/stakeholder-prepAgenda, talking points, objections, and follow-up email for a stakeholder call
/sow-reviewStatement of Work risks, gaps, and negotiation points
/change-requestFormal change request document
/exec-summaryOne-page executive summary of a long document
/deliverable-qaQA a deliverable against consulting quality standards
/code-review-lightPlain-English read of a code or data artifact
/weekly-briefRead-only Monday brief for a project folder; safe to schedule

Subagent: ask for "a second look" or "fresh eyes" on a file and Claude delegates to the second-reviewer agent in .claude/agents/, which reads the file cold with no memory of the drafting conversation.


Project Notes

Add running notes here as the engagement progresses. Commit updates so the whole team shares context. Claude also keeps its own auto memory per repository; this section is the shared, human-written record.

Key decisions:

  • [Date] | [Decision] | [Rationale] | [Owner]

Open risks:

  • [Risk description] | [Owner] | [Status]

Team / capacity notes:

  • [Person] | [Role] | [Availability / travel / coverage notes]

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.