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/observations-schema.md
View on GitHub# Observations Schema
Defines `.shaktra/stories/<story_id>/.observations.yml` — per-story observations written by agents during workflow execution. Consumed by the memory-curator during post-workflow consolidation.
## Schema
```yaml
observations:
- id: string # "OB-001" — sequential within story
agent: string # agent name: "developer" | "sw-quality" | "sw-engineer" | "architect" | "bug-diagnostician" | "test-agent" | "product-manager"
phase: string # TDD phase: "plan" | "plan-review" | "tests" | "code" | "code-gate" | "quality" | "review" | "diagnosis"
type: string # "discovery" | "quality-loop-finding" | "fix-rationale" | "deviation" | "observation" | "consistency-check"
text: string # what was observed (1-3 sentences)
tags: [string] # freeform keywords, used for matching during consolidation
importance: integer # 1-10 (7+ = strong promotion candidate)
# Optional fields (type-dependent):
severity: string # P0-P3, only for quality-loop-finding type
resolved: boolean # only for quality-loop-finding type
iterations: integer # fix attempt count, only for quality-loop-finding type
principle_id: string # only for consistency-check type — references PR-NNN
relationship: string # "reinforce" | "weaken" | "contradict", only for consistency-check type
```
## Lifecycle
1. **CREATE** — orchestrator creates empty `.observations.yml` at workflow start
2. **APPEND** — agents append observations during their phase
3. **CONSOLIDATE** — memory-curator reads and synthesizes into long-term stores
4. **ARCHIVE** — observations stay with the story directory for audit trail
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 |