Context Creation (Brownfield Back-Fill)
A codeArbiter skill that scans an existing codebase with six parallel read-only scouts and back-fills the full set of project-state documents without guessing.
What it does
Wraps an existing (brownfield) codebase in project state documentation, derived strictly from what is already on disk.
- Pre-flight: verifies
.codearbiter/CONTEXT.mdlacks the<!--INITIALIZED-->marker and that meaningful source exists; otherwise routes todecomposeor to normal operation. - Six parallel scouts: tech stack (A), infrastructure/CI (B), architecture (C), security posture (D), testing (E), data model (F). Each reads one slice and returns a structured report — file paths, line numbers, named values — never raw code.
- Confidence-graded synthesis: HIGH findings are written as fact, MEDIUM with an "inferred from…" note, LOW as
[CONFIRM-NN]placeholders with an ID, the unknown, why it matters, and what resolves it. - Gap interview: one targeted question per open item; vague answers are challenged, deferrals are logged in
open-questions.md. - Write and lock: emits
CONTEXT.md,tech-stack.md,coding-standards.md,security-controls.md,open-questions.md,open-tasks.md,overrides.log(plus a conditional, marker-gatedrelease-targets.md), then writes the initialization marker.
Who it's for
- Teams already running the codeArbiter plugin who need to onboard an undocumented legacy repo.
- Engineers who want a large codebase summarized without loading raw source into the orchestrator's context window.
- Anyone who needs a security-posture write-up that records paths and line numbers only, never secret values.
Caveat: it depends on the
.codearbiter/convention and plugin scripts such as{{PLUGIN_ROOT}}/hooks/taskwrite.py, so it is not practical as a standalone skill.
Examples
- Onboarding a 5-year-old undocumented monorepo — run
/create-context; the scouts readpackage.json,.github/workflows/,prisma/schema.prismaand produce drafts covering stack, build/test commands, and entity inventory. - Automatic startup routing — a session opens with
CONTEXT.mdpresent but no<!--INITIALIZED-->marker, so this skill takes over and finishes the half-done initialization. - Release target inference — with exactly one root manifest and one changelog, it writes a HIGH-confidence
release-targets.mdrow; anything ambiguous becomes a[CONFIRM-NN]instead of a guess.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/arbiterForge/codeArbiter/HEAD/core/surface/skills/context-creation/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the core/surface/skills/context-creation folder from the GitHub repo arbiterForge/codeArbiter into my ~/.claude/skills/context-creation/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/arbiterForge/codeArbiter.git && mkdir -p ~/.claude/skills/context-creation && cp -r codeArbiter/core/surface/skills/context-creation/* ~/.claude/skills/context-creation/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and move to your working directory.
- Clone the repository:
git clone https://github.com/arbiterForge/codeArbiter.git - Create the skill folder:
mkdir -p ~/.claude/skills/context-creation - Copy the files:
cp -r codeArbiter/core/surface/skills/context-creation/* ~/.claude/skills/context-creation/ - Because this skill relies on the whole codeArbiter plugin (
hooks/taskwrite.py,hooks/_releaselib.py,includes/cut-docs.md), it is strongly recommended to install the full plugin per the repository README rather than this folder alone. - Restart Claude Code, open an undocumented existing repo, and run
/create-context— or simply ask: "build project context from this existing codebase." - Review the scout reports, answer each
[CONFIRM-NN]question one at a time, and the.codearbiter/directory will be populated and locked as initialized.