Shaktra Reference — Single Source of Truth
This skill contains canonical definitions for the Shaktra framework. No other file may redefine the constants, taxonomies, or standards declared here. Agents and skills reference these files — they never duplicate them.
Loading
Agents load this skill via their skills frontmatter. Story-related schemas (story-schema, story-tiers, sprint-schema) live in shaktra-stories. All other schemas and quality references live here.
Sub-Files
| File |
Purpose |
severity-taxonomy.md |
P0-P3 severity levels, examples, merge gate logic |
quality-principles.md |
10 core principles with verification checks |
guard-tokens.md |
14 core tokens for phase/quality/workflow signaling (domain skills define additional tokens) |
quality-dimensions.md |
13 review dimensions (A-M) with key checks and P0 triggers |
schemas/handoff-schema.md |
TDD state machine — phases, transitions, validation rules |
schemas/settings-schema.md |
Framework config — types, defaults, consumer reference |
schemas/principles-schema.md |
Principles store — synthesized from observations, 14 categories, confidence lifecycle |
schemas/observations-schema.md |
Per-story observations — agent-written during workflow execution |
schemas/anti-patterns-schema.md |
Anti-patterns — failure patterns with recommended alternatives |
schemas/procedures-schema.md |
Procedures — workflow-level adaptation learnings |
schemas/briefing-schema.md |
Story briefings — filtered view of long-term knowledge |
schemas/design-doc-schema.md |
Design doc sections — tier-scaled structure |
schemas/refactoring-handoff-schema.md |
Refactoring state machine — phases, transitions, baseline metrics |
schemas/prd-schema.md |
PRD validation — required sections, quality checks |
schemas/persona-schema.md |
Persona YAML — fields, evidence requirements |
schemas/journey-schema.md |
Journey map YAML — stages, touchpoints, opportunities |
schemas/research-schema.md |
Research synthesis YAML — themes, patterns, recommendations |
schemas/analysis-manifest-schema.md |
Analysis checkpoint — dimension progress, resumability, status transitions |
Moved to shaktra-stories: story-schema.md, story-tiers.md, sprint-schema.md — loaded by agents that work with stories and sprints.
Agent Loading Guide
| Agent Role |
From shaktra-reference |
From shaktra-stories |
| SW Quality |
severity-taxonomy, quality-principles, quality-dimensions, schemas/handoff-schema, schemas/principles-schema |
— |
| CR Analyzer |
severity-taxonomy, quality-principles, quality-dimensions |
— |
| SW Engineer, Developer |
severity-taxonomy, quality-principles, guard-tokens, schemas/handoff-schema |
story-schema, story-tiers |
| Test Agent |
severity-taxonomy, guard-tokens, schemas/handoff-schema |
— |
| TPM Quality |
severity-taxonomy, quality-dimensions, guard-tokens, schemas/design-doc-schema |
story-schema, story-tiers |
| Scrum Master |
— |
story-schema, story-tiers, sprint-schema |
| Architect |
quality-principles, quality-dimensions, schemas/design-doc-schema |
— |
| Memory Curator |
schemas/principles-schema, schemas/observations-schema, schemas/anti-patterns-schema, schemas/procedures-schema, schemas/handoff-schema |
— |
| Bug Diagnostician |
severity-taxonomy, guard-tokens |
story-schema |
| CBA Analyzer |
quality-principles, schemas/principles-schema, schemas/analysis-manifest-schema |
— |
| Product Manager |
schemas/principles-schema, schemas/prd-schema, schemas/persona-schema, schemas/journey-schema, schemas/research-schema |
story-schema, story-tiers, sprint-schema |
Note: Memory Curator also loads the shaktra-memory skill for consolidation algorithms.
1---2name: shaktra-reference3description: Shared constants, quality standards, and state schemas for all Shaktra agents. Defines severity taxonomy, quality principles, guard tokens, review dimensions, and YAML schemas.4---56# Shaktra Reference — Single Source of Truth78This skill contains canonical definitions for the Shaktra framework. No other file may redefine the constants, taxonomies, or standards declared here. Agents and skills reference these files — they never duplicate them.910## Loading1112Agents load this skill via their `skills` frontmatter. Story-related schemas (story-schema, story-tiers, sprint-schema) live in `shaktra-stories`. All other schemas and quality references live here.1314## Sub-Files1516| File | Purpose |17|---|---|18| `severity-taxonomy.md` | P0-P3 severity levels, examples, merge gate logic |19| `quality-principles.md` | 10 core principles with verification checks |20| `guard-tokens.md` | 14 core tokens for phase/quality/workflow signaling (domain skills define additional tokens) |21| `quality-dimensions.md` | 13 review dimensions (A-M) with key checks and P0 triggers |22| `schemas/handoff-schema.md` | TDD state machine — phases, transitions, validation rules |23| `schemas/settings-schema.md` | Framework config — types, defaults, consumer reference |24| `schemas/principles-schema.md` | Principles store — synthesized from observations, 14 categories, confidence lifecycle |25| `schemas/observations-schema.md` | Per-story observations — agent-written during workflow execution |26| `schemas/anti-patterns-schema.md` | Anti-patterns — failure patterns with recommended alternatives |27| `schemas/procedures-schema.md` | Procedures — workflow-level adaptation learnings |28| `schemas/briefing-schema.md` | Story briefings — filtered view of long-term knowledge |29| `schemas/design-doc-schema.md` | Design doc sections — tier-scaled structure |30| `schemas/refactoring-handoff-schema.md` | Refactoring state machine — phases, transitions, baseline metrics |31| `schemas/prd-schema.md` | PRD validation — required sections, quality checks |32| `schemas/persona-schema.md` | Persona YAML — fields, evidence requirements |33| `schemas/journey-schema.md` | Journey map YAML — stages, touchpoints, opportunities |34| `schemas/research-schema.md` | Research synthesis YAML — themes, patterns, recommendations |35| `schemas/analysis-manifest-schema.md` | Analysis checkpoint — dimension progress, resumability, status transitions |3637**Moved to `shaktra-stories`:** story-schema.md, story-tiers.md, sprint-schema.md — loaded by agents that work with stories and sprints.3839## Agent Loading Guide4041| Agent Role | From shaktra-reference | From shaktra-stories |42|---|---|---|43| SW Quality | severity-taxonomy, quality-principles, quality-dimensions, schemas/handoff-schema, schemas/principles-schema | — |44| CR Analyzer | severity-taxonomy, quality-principles, quality-dimensions | — |45| SW Engineer, Developer | severity-taxonomy, quality-principles, guard-tokens, schemas/handoff-schema | story-schema, story-tiers |46| Test Agent | severity-taxonomy, guard-tokens, schemas/handoff-schema | — |47| TPM Quality | severity-taxonomy, quality-dimensions, guard-tokens, schemas/design-doc-schema | story-schema, story-tiers |48| Scrum Master | — | story-schema, story-tiers, sprint-schema |49| Architect | quality-principles, quality-dimensions, schemas/design-doc-schema | — |50| Memory Curator | schemas/principles-schema, schemas/observations-schema, schemas/anti-patterns-schema, schemas/procedures-schema, schemas/handoff-schema | — |51| Bug Diagnostician | severity-taxonomy, guard-tokens | story-schema |52| CBA Analyzer | quality-principles, schemas/principles-schema, schemas/analysis-manifest-schema | — |53| Product Manager | schemas/principles-schema, schemas/prd-schema, schemas/persona-schema, schemas/journey-schema, schemas/research-schema | story-schema, story-tiers, sprint-schema |5455**Note:** Memory Curator also loads the `shaktra-memory` skill for consolidation algorithms.
im-shashanks