refine-project-context

Installation
SKILL.md

Refine Project Context

Update .agents/PROJECT_CONTEXT.md in place based on user feedback or codebase validation. The file must already exist; this skill does not create it from scratch.

Do NOT start implementing. Only update the document (and optionally .agents/TECHNICAL_DEBT.md in challenge mode).

Two modes available — determined by the mode context variable:

  • Editor mode (default) — apply specific changes requested by the user.
  • Challenger mode (mode = "challenger") — validate PROJECT_CONTEXT.md against the actual codebase, detect discrepancies, and present findings individually for user triage.

Reasoning Protocol

Use Chain of Draft (CoD) for all internal reasoning steps. CoD applies only to your private scratchpad — never to user-facing output or document updates, which must remain complete and accurate.

Installs
2
First Seen
Mar 25, 2026