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/refactoring-handoff-schema.md
View on GitHub# Refactoring Handoff Schema
Defines `.shaktra/refactoring/<target>/refactoring-handoff.yml` — the state machine that tracks a refactoring session through ASSESS → FORTIFY → TRANSFORM → VERIFY → MEMORY.
## Identity
```yaml
target: string # file or module path being refactored
tier: string # "targeted" | "structural"
current_phase: string # "pending" | "assess" | "fortify" | "transform" | "verify" | "complete" | "failed"
completed_phases: [string] # append-only log
```
## Assessment Summary
```yaml
assessment:
smells_detected:
- id: string # smell ID (BL-01, CP-02, etc.)
location: "file:line"
severity: string # from smell catalog
description: string
proposed_transforms:
- id: string # transform ID (EX-01, MV-02, etc.)
target_smell: string # smell ID being addressed
description: string
risk: low | medium | high
order: integer # execution order
baseline_metrics:
test_count: integer
coverage: integer # percentage
files_in_scope: integer
```
## Fortify Summary
```yaml
fortify:
coverage_before: integer # percentage
coverage_after: integer # after characterization tests
characterization_tests_added: integer
safety_threshold_met: boolean
force_mode: boolean # user acknowledged risk — no sufficient tests
```
## Transform Log
```yaml
transforms:
- id: string # transform ID
status: applied | reverted | skipped
files_changed: [string]
tests_after: pass | fail
notes: string # reason for revert/skip if applicable
```
## Verify Summary
```yaml
verify:
all_tests_green: boolean
coverage_change: integer # delta from baseline (should be >= 0)
smells_resolved: integer
smells_remaining: integer
metrics_improved: boolean
```
## Memory Guard
```yaml
memory_captured: boolean # default: false — must be true before completion
```
## Phase Transitions
| From | To | Guard |
|---|---|---|
| assess | fortify | `assessment.smells_detected` is non-empty; transforms proposed |
| fortify | transform | `fortify.safety_threshold_met == true` OR `fortify.force_mode == true` |
| transform | verify | All transforms applied, reverted, or skipped |
| verify | complete | `verify.all_tests_green == true`; `verify.coverage_change >= 0`; `memory_captured == true` |
| _any_ | failed | Unrecoverable error or user abort |
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: 472k | 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 |