sprint-guidelines-ingestion

sprint-guidelines-ingestion

Produces a single, authoritative guidelines document from three ordered layers before any planning action begins. The merged document governs how routing decisions are made, how the plan is formatted, and how label mappings can be customised.

Layers

Layer 1 — Plugin Defaults

Default sprint planning guidelines bundled with the plugin. Covers:

• ## Routing Preferences — default agent assignment rules per domain
• ## Label Mapping — how labels map to domain agents
• ## Plan Formatting — output structure conventions for sprint-plan.md
• ## Dependency Rules — default inferred ordering (DB before API before UI)
• ## Confidence Threshold — default routing confidence cutoff (0.6)

Layer 2 — Team Custom Guidelines

The team may supply a custom guidelines file via .sprint-agent.json:

{
  "guidelines": "docs/sprint-guidelines.md"
}

The path is relative to the workspace root. If configured but missing, emit a warning.

Example custom guidelines:

## Routing Preferences
- Always route tickets labelled `auth` to security-coding-agent, not backend-coding-agent
- Route tickets with component `Infrastructure` to devops-coding-agent regardless of other labels

## Confidence Threshold
- Minimum confidence for auto-assignment: 0.7 (stricter than default)

Layer 3 — Per-Invocation Instructions

Inline instructions in the current prompt are treated as the highest-priority layer, injected as a ## Overrides section.

Merge Algorithm

Section-level (## heading) replacement:

1. Start with Layer 1 (plugin defaults)
2. For each ## section in Layer 2: replace matching Layer 1 section or append if new
3. Append ## Overrides from Layer 3 instructions (omit if none)
4. Sections in Layer 1 with no Layer 2 counterpart are kept unchanged

The algorithm is deterministic. The unit of replacement is always the complete content between one ## heading and the next.

Output

{
  "mergedGuidelinesPath": "<in-memory>",
  "layersApplied": {
    "pluginDefaults": "sprint-coding-agent/defaults/planning-guidelines.md",
    "teamCustom": "<resolved-path-or-null>",
    "perInvocationOverrides": false
  },
  "sectionsFromDefaults": 5,
  "sectionsReplaced": 1,
  "sectionsAdded": 0,
  "warnings": []
}