debrief

Record team observations into role-specific LEARNING.md or project DEBRIEF.md files.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/hilbertp/liberation-of-bajor --skill debrief-hilbertp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debrief
Source: https://github.com/hilbertp/liberation-of-bajor/tree/main/.claude/skills/debrief
Command: npx skills add https://github.com/hilbertp/liberation-of-bajor --skill debrief-hilbertp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams repeatedly lose valuable insights when each AI role starts a new session, leading to repeated mistakes and missed opportunities for improvement. This skill ensures that every useful observation is recorded at the moment it occurs, creating a shared institutional memory.

Core Features & Use Cases

  • Two destinations: role‑specific LEARNING.md for cross‑project knowledge, and project‑level DEBRIEF.md for raw observations awaiting triage.
  • Automatic capture triggers: friction points, platform constraints, corrections from leadership, successful or failed decisions, and end‑of‑deliverable reflections.
  • Use case example: When you discover a platform limitation while implementing a feature, you invoke the debrief skill to immediately append a learning to your role’s LEARNING.md; if you encounter a workflow bottleneck, you add it to the shared DEBRIEF.md for later review.

Quick Start

Ask the debrief skill to record a new learning or observation directly into your role's LEARNING.md or the project DEBRIEF.md.

Frequently Asked Questions about debrief

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture team learnings and observations in markdown?

To capture team learnings in markdown, you record friction points, platform constraints, or decisions directly into role-specific LEARNING.md or project-level DEBRIEF.md files without external services.

What is the best way to build institutional memory for AI team sessions?

Building institutional memory involves appending observations and corrections to markdown files at the moment they occur, ensuring repeated mistakes are avoided when any AI role starts a new session.

How do I record a workflow bottleneck for later triage?

You record a workflow bottleneck for triage by appending the raw observation to the shared project DEBRIEF.md file, separating immediate role learnings from broader project-level issues.

Can I use this to log cross-project knowledge for specific roles?

Yes, you can log cross-project knowledge by writing entries to a role-specific LEARNING.md file, capturing successful or failed decisions to maintain a continuous record for that role.

When should I trigger a learning capture in a repository?

You trigger learning capture when friction points, platform limitations, leadership corrections, or end-of-deliverable reflections occur, immediately writing the entry to markdown to preserve context.

Do I need external services to store team observations?

No, you do not need external services to store team observations; the process writes entries directly to markdown files in the repository using only the current environment.