im-shashanks/claude-plugins / shaktra/skills/shaktra-reference
shaktra-reference
VerifiedShared constants, quality standards, and state schemas for all Shaktra agents. Defines severity taxonomy, quality principles, guard tokens, review dimensions, and YAML schemas.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.0 KB |
| guard-tokens.md | markdown | 3.0 KB |
| quality-dimensions.md | markdown | 4.0 KB |
| quality-principles.md | markdown | 3.9 KB |
| schemas/analysis-manifest-schema.md | markdown | 2.8 KB |
| schemas/anti-patterns-schema.md | markdown | 1.6 KB |
| schemas/briefing-schema.md | markdown | 2.9 KB |
| schemas/design-doc-schema.md | markdown | 4.9 KB |
| schemas/handoff-schema.md | markdown | 4.2 KB |
| schemas/journey-schema.md | markdown | 3.4 KB |
| schemas/observations-schema.md | markdown | 1.7 KB |
| schemas/persona-schema.md | markdown | 2.8 KB |
| schemas/prd-schema.md | markdown | 3.3 KB |
| schemas/principles-schema.md | markdown | 2.3 KB |
| schemas/procedures-schema.md | markdown | 1.7 KB |
| schemas/refactoring-handoff-schema.md | markdown | 2.4 KB |
| schemas/research-schema.md | markdown | 3.7 KB |
| schemas/settings-schema.md | markdown | 7.7 KB |
| severity-taxonomy.md | markdown | 3.2 KB |
schemas/principles-schema.md
View on GitHub# Principles Schema
Defines `.shaktra/memory/principles.yml` — synthesized principles from cross-story observations. The primary long-term knowledge store for project patterns, techniques, and constraints.
## Schema
```yaml
principles:
- id: string # "PR-001" — sequential
text: string # the principle statement (20-500 chars)
categories: [string] # 1-3 from the 14 categories (see Categories below)
guidance: [string] # 1-5 actionable rules
confidence: float # 0.2-1.0
source_count: integer # number of supporting observations
tags: [string] # for retrieval matching
roles: [string] # "developer" | "sw-engineer" | "architect" | "sw-quality" | "test-agent" | etc.
scope: string # "project" | "universal"
status: string # "active" | "archived" | "superseded"
supersedes: string # optional — PR-ID of superseded principle
source: string # story_id or "migrated:DC-NNN"
created: string # ISO 8601 date
last_reinforced: string # ISO 8601 date (optional)
```
## Categories
Reused from the decisions-schema 14-category taxonomy:
| # | Category | Covers |
|---|---|---|
| 1 | correctness | Logic, invariants, contracts |
| 2 | reliability | Fault tolerance, retry, recovery |
| 3 | performance | Latency, throughput, resource use |
| 4 | security | Auth, injection, secrets, access |
| 5 | maintainability | Readability, modularity, coupling |
| 6 | testability | Mockability, isolation, determinism |
| 7 | observability | Logging, metrics, tracing |
| 8 | scalability | Load, concurrency, partitioning |
| 9 | compatibility | APIs, versions, migrations |
| 10 | accessibility | A11y standards, assistive tech |
| 11 | usability | UX patterns, error messages |
| 12 | cost | Infrastructure, API calls, storage |
| 13 | compliance | Regulatory, licensing, data governance |
| 14 | consistency | Naming, patterns, conventions |
## Lifecycle
1. **SEED** — migrated from `decisions.yml` or created from high-importance observations
2. **REINFORCE** — confidence increases when observations match (+0.08)
3. **WEAKEN** — confidence decreases when observations partially contradict (-0.08)
4. **SUPERSEDE** — new principle replaces old (set `status: superseded`, `supersedes` references old ID)
5. **ARCHIVE** — confidence drops below threshold (set `status: archived`)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |