context-creation

Initialize brownfield codebases into codeArbiter project state with scout analysis.

139|7|Updated May 8, 2026
One-click install
npx skills add https://github.com/arbiterForge/codeArbiter --skill context-creation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-creation
Source: https://github.com/arbiterForge/codeArbiter/tree/main/plugins/ca/skills/context-creation
Command: npx skills add https://github.com/arbiterForge/codeArbiter --skill context-creation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns an existing brownfield codebase into initialized codeArbiter project state without guessing, so the system can understand what already exists and enforce gates safely.

Core Features & Use Cases

  • Brownfield initialization: Detects when source code already exists but .codearbiter/CONTEXT.md is not initialized, then starts extraction instead of scaffolding from scratch.
  • Scouted analysis: Uses six parallel scout passes to inspect stack, infrastructure, architecture, security, testing, and data model signals without loading raw source into the main context.
  • Gap handling: Flags unknowns, asks targeted questions, and records deferred items so the resulting project state is explicit and auditable.
  • Project-state synthesis: Writes context, tech stack, coding standards, security controls, questions, tasks, and override log files, then locks initialization with a marker.
  • Use case: A team drops codeArbiter into a mature repository and needs the repo documented, gated, and ready for normal orchestration before feature work begins.

Quick Start

Use the context-creation skill to initialize project state for this existing repository and produce the required .codearbiter files.

Frequently Asked Questions about context-creation

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

FAQPage Schema
How do I backfill project context for an existing codebase?

To initialize project state for an existing repository, the context-creation skill performs six parallel scout passes to inspect stack, infrastructure, architecture, security, testing, and data model signals. It then synthesizes these signals into .codearbiter documentation files and locks initialization with a marker.

What is brownfield initialization in codebase analysis?

Brownfield initialization detects when source code already exists but project context is not initialized, triggering extraction instead of scaffolding from scratch. This ensures the system understands existing code and can enforce gates safely without guessing prior state.

How does scouted analysis work for existing repositories?

Scouted analysis uses six parallel scout passes to inspect stack, infrastructure, architecture, security, testing, and data model signals. This approach extracts project context without loading raw source code into the main context, keeping the analysis lightweight and focused.

Can I use context extraction on a mature repository with missing documentation?

Yes, context extraction is designed for mature repositories that need documentation, gating, and orchestration readiness. It flags unknowns, asks targeted questions, and records deferred items so the resulting project state is explicit, auditable, and prepared for normal feature work.

What are the limitations of automated codebase context creation?

Automated codebase context creation may encounter gaps where signals are unknown or unclear. In these cases, it flags unknowns and records deferred items rather than guessing, meaning some manual gap resolution may be required to achieve a fully auditable project state.