Skip to content

im-shashanks/claude-plugins / shaktra/skills/shaktra-reference

shaktra-reference

Verified

Shared constants, quality standards, and state schemas for all Shaktra agents. Defines severity taxonomy, quality principles, guard tokens, review dimensions, and YAML schemas.

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`)
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall