workflow pipeline
Analyze Context
MANDATORY first step. Scans codebase and instructions to build a 'Context Brief' before any specs or code are written.
Analyze Context Skill
Goal: Stop guessing. Start knowing.
The Protocol
1. Instruction Discovery
You must read the following global instructions to ground yourself:
.github/instructions/architecture.instructions.md(Layers & Rules).github/instructions/conventions.instructions.md(Naming & patterns).github/instructions/dependencies.instructions.md(NuGet & 3rd party)
Conditional Reads:
- If Database changes:
.github/instructions/marten.models.instructions.md - If New Accessor:
.github/instructions/accessor-implementation.instructions.md - If Testing:
.github/instructions/integration.tests.instructions.md
2. Pattern Matching (The "Reference Implementation")
You must find one specific file in the existing codebase that solves a similar problem to the current story.
Example: "This story adds a new profile. EmployeePersonalProfile.cs is the reference."
Action: Read that file. You will need to cite it later.
3. Architecture Context
Identify the Host, Manager, Engine, and Accessor involved.
Verify layer directions (e.g., Engine → Accessor, NEVER Accessor → Manager).
4. Output Generation
Create planning/context-brief.md in the story folder.
Content Requirements for context-brief.md:
- Governing Instructions: List the specific
.github/instructionsfiles that apply. - Reference Pattern: The
path/to/existing/code.csyou will mimic. - Architectural Touchpoints: List the specific projects/services involved.
- Reflexion: A 1-sentence statement confirming you have read the reference file.