221 lines
14 KiB
JSON
221 lines
14 KiB
JSON
{
|
|
"track_id": "superpowers_review_20260619",
|
|
"name": "Superpowers Skills Review (Direct Utilization in Manual Slop)",
|
|
"initialized": "2026-06-19",
|
|
"owner": "tier1-orchestrator",
|
|
"priority": "medium-high",
|
|
"status": "spec_written",
|
|
"type": "research-only (no src/, no tests/, no agent-directive changes)",
|
|
"blocked_by": [
|
|
"chronology_20260619"
|
|
],
|
|
"blocks": [],
|
|
"sibling_tracks": [
|
|
"nagent_review_20260608",
|
|
"fable_review_20260617",
|
|
"intent_dsl_survey_20260612"
|
|
],
|
|
"rationale": "The user wants a reference document reviewing the 14 superpowers-plugin skills against Manual Slop's existing AI-directive corpus, with verdicts on which skills are already integrated, which are partially integrated (and where the gaps are), which are not integrated but should be, and which are explicitly not applicable. The review also covers the dual-convention problem (docs/superpowers/specs/*.md vs conductor/tracks/<id>/spec.md) and any other AI-directive observations. The track is research-only; the actual conservative changes become follow-up tracks in the user's deferred rebuild (parallel to the deferred nagent-rebuild). User framing (2026-06-19): 'conservative changes incrementally to improve AI performance and quality standards of output. I'm not after speed, pure discipline, high grade inference, good tool use, and careful text generation.'",
|
|
"format_choice": "conductor convention (per user Q4 = A); all artifacts at conductor/tracks/superpowers_review_20260619/. Spec.md, plan.md, metadata.json, state.toml, report.md, comparison_table.md, decisions.md, nagent_takeaways_superpowers_20260619.md.",
|
|
"scope": {
|
|
"new_files": [
|
|
"conductor/tracks/superpowers_review_20260619/spec.md",
|
|
"conductor/tracks/superpowers_review_20260619/metadata.json",
|
|
"conductor/tracks/superpowers_review_20260619/state.toml",
|
|
"conductor/tracks/superpowers_review_20260619/report.md",
|
|
"conductor/tracks/superpowers_review_20260619/comparison_table.md",
|
|
"conductor/tracks/superpowers_review_20260619/decisions.md",
|
|
"conductor/tracks/superpowers_review_20260619/nagent_takeaways_superpowers_20260619.md"
|
|
],
|
|
"modified_files": [
|
|
"conductor/tracks.md (register track in Active section)"
|
|
],
|
|
"deleted_files": [],
|
|
"no_src_changes": true,
|
|
"no_test_changes": true,
|
|
"no_agent_directive_changes": true
|
|
},
|
|
"estimated_effort": {
|
|
"method": "scope (per conductor/workflow.md Tier 1 Track Initialization Rules). NO day estimates.",
|
|
"phase_1": "1 task: setup (skeleton files + tracks.md registration)",
|
|
"phase_2": "4 tasks: sections 1-4 (1 brief + 3 deep-dives)",
|
|
"phase_3": "4 tasks: sections 5-8 (3 deep-dives + 1 medium)",
|
|
"phase_4": "6 tasks: sections 9-14 (brief/medium mix)",
|
|
"phase_5": "1 task: section 15 (MMA cluster, 5 sub-sections)",
|
|
"phase_6": "1 task: section 16 (dual-convention + anything else)",
|
|
"phase_7": "3 tasks: side artifacts (comparison_table, decisions, nagent_takeaways bridge)",
|
|
"phase_8": "1 task: self-review (placeholder scan, internal consistency, scope check, ambiguity check)",
|
|
"phase_9": "1 task: user review gate",
|
|
"phase_10": "1 task: finalize (state.toml to current_phase=10, tracks.md Recently Completed)",
|
|
"summary": "10 phases, 21 atomic commits, 7 new files + 1 modified file. Scope: ~2,800-4,500 LOC across 16 report sections; ~700 LOC across 3 side artifacts. No day estimates."
|
|
},
|
|
"report_sections": [
|
|
{"#": 1, "skill": "using-superpowers", "depth": "brief (50-100 LOC)"},
|
|
{"#": 2, "skill": "brainstorming", "depth": "deep-dive (200-400 LOC)"},
|
|
{"#": 3, "skill": "writing-plans", "depth": "deep-dive (200-400 LOC)"},
|
|
{"#": 4, "skill": "test-driven-development", "depth": "deep-dive (200-400 LOC)"},
|
|
{"#": 5, "skill": "verification-before-completion", "depth": "deep-dive (200-400 LOC)"},
|
|
{"#": 6, "skill": "systematic-debugging", "depth": "deep-dive (200-400 LOC)"},
|
|
{"#": 7, "skill": "subagent-driven-development", "depth": "deep-dive (200-400 LOC)"},
|
|
{"#": 8, "skill": "executing-plans", "depth": "medium (100-250 LOC)"},
|
|
{"#": 9, "skill": "dispatching-parallel-agents", "depth": "brief (50-150 LOC)"},
|
|
{"#": 10, "skill": "receiving-code-review", "depth": "medium (100-250 LOC)"},
|
|
{"#": 11, "skill": "requesting-code-review", "depth": "brief (50-150 LOC)"},
|
|
{"#": 12, "skill": "finishing-a-development-branch", "depth": "brief (50-150 LOC)"},
|
|
{"#": 13, "skill": "using-git-worktrees", "depth": "brief (50-150 LOC)"},
|
|
{"#": 14, "skill": "writing-skills", "depth": "medium (100-250 LOC)"},
|
|
{"#": 15, "skill": "MMA Skills Cluster (5 sub-sections)", "depth": "medium-large (300-500 LOC)"},
|
|
{"#": 16, "skill": "Dual-Convention + Anything Else (cross-cutting)", "depth": "medium (200-400 LOC)"}
|
|
],
|
|
"verdict_taxonomy": {
|
|
"primary": ["PARITY", "PARTIAL", "GAP", "ARCH-DIFF", "SUBSUMED"],
|
|
"integration_tag": ["INTEGRATED", "INTEGRATE-PARTIAL", "INTEGRATE", "REJECT-WITH-REASON", "N/A"],
|
|
"format": "hybrid: primary + integration_tag per section"
|
|
},
|
|
"side_artifacts": [
|
|
{
|
|
"file": "comparison_table.md",
|
|
"format": "20-row flat table (14 superpowers + 5 MMA + 1 dual-convention)",
|
|
"columns": ["Skill", "Primary verdict", "Integration tag", "Section LOC", "Recommended change", "Cross-ref"],
|
|
"approx_loc": 700
|
|
},
|
|
{
|
|
"file": "decisions.md",
|
|
"format": "15-25 entries sorted by priority (HIGH -> MEDIUM -> LOW)",
|
|
"fields": ["#", "Priority", "Skill", "Change", "Destination file", "Effort", "Evidence"],
|
|
"approx_loc": 500
|
|
},
|
|
{
|
|
"file": "nagent_takeaways_superpowers_20260619.md",
|
|
"format": "5-part bridge to nagent_review + fable_review",
|
|
"sections": ["TL;DR", "Cross-reference table", "New candidates", "Contradictions", "Fable pointer"],
|
|
"approx_loc": 150
|
|
}
|
|
],
|
|
"verification_criteria": [
|
|
"report.md has all 16 sections present and non-empty",
|
|
"Every section ends with the hybrid verdict block (primary + integration_tag)",
|
|
"comparison_table.md has all 20 rows",
|
|
"decisions.md has 15-25 entries sorted by priority",
|
|
"nagent_takeaways_superpowers_20260619.md exists with the 5-part bridge structure",
|
|
"No src/ / tests/ / AGENTS.md / conductor/*.md / .opencode/agents/*.md / .opencode/commands/*.md / conductor/code_styleguides/*.md changes (research-only)",
|
|
"Self-review pass complete (placeholder scan, internal consistency, scope check, ambiguity check)",
|
|
"User has reviewed and approved the final report + side artifacts",
|
|
"conductor/tracks.md updated to register the track",
|
|
"All 21 commits are atomic with git notes attached",
|
|
"state.toml final state is current_phase=10 and status=active",
|
|
"No new src/*.py or scripts/audit_*.py files created (per AGENTS.md hard rules)"
|
|
],
|
|
"risk_register": [
|
|
{
|
|
"id": "R1",
|
|
"title": "Section verdict inconsistency",
|
|
"likelihood": "medium",
|
|
"scope_impact": "comparison_table.md becomes hard to scan; the user cannot compare verdicts across sections",
|
|
"mitigation": "The verdict block template (spec section 3.2) is fixed; the self-review pass (Phase 8) catches inconsistencies."
|
|
},
|
|
{
|
|
"id": "R2",
|
|
"title": "Section 16 'anything else' findings balloon",
|
|
"likelihood": "medium",
|
|
"scope_impact": "Section 16 becomes a full re-review of the codebase, exceeding the report's scope",
|
|
"mitigation": "Section 16 has a hard limit: findings are one paragraph each. Bigger findings become follow-up tracks logged in decisions.md."
|
|
},
|
|
{
|
|
"id": "R3",
|
|
"title": "decisions.md becomes a wish-list",
|
|
"likelihood": "medium",
|
|
"scope_impact": "The decisions lose the 'conservative' framing; the user is overwhelmed",
|
|
"mitigation": "The user-review gate (Phase 9) is the check. decisions.md format requires a 'Destination file' field so the user can spot scope-creep recommendations."
|
|
},
|
|
{
|
|
"id": "R4",
|
|
"title": "nagent_takeaways bridge is too thin",
|
|
"likelihood": "low",
|
|
"scope_impact": "Minimal; the bridge is a pointer, not a co-equal report",
|
|
"mitigation": "The bridge is intentionally ~150 LOC. If it grows beyond 250 LOC, scope is too large."
|
|
},
|
|
{
|
|
"id": "R5",
|
|
"title": "21 commits become hard to review",
|
|
"likelihood": "low",
|
|
"scope_impact": "Minimal; atomic commits are the project's convention",
|
|
"mitigation": "The commits are mechanical; the user reviews the report as a single document, not commit-by-commit."
|
|
},
|
|
{
|
|
"id": "R6",
|
|
"title": "Dual-convention section argues for a position the user disagrees with",
|
|
"likelihood": "medium",
|
|
"scope_impact": "Section 16 becomes a debate rather than a survey",
|
|
"mitigation": "Section 16 presents both options (keep conductor convention vs. adopt superpowers convention vs. split by artifact type); the user picks in the deferred rebuild."
|
|
},
|
|
{
|
|
"id": "R7",
|
|
"title": "Chronology track takes longer than expected",
|
|
"likelihood": "high",
|
|
"scope_impact": "None on this track's quality; only delays the start",
|
|
"mitigation": "This track is blocked_by chronology_20260619; the order is fixed. The chronology track is on its own clock."
|
|
},
|
|
{
|
|
"id": "R8",
|
|
"title": "Superpowers plugin updates mid-review",
|
|
"likelihood": "low",
|
|
"scope_impact": "Minimal; the report is a snapshot",
|
|
"mitigation": "The report notes the plugin version / commit at the start of Phase 2 and is dated 2026-06-19. If the plugin updates, the verdict rationale flags the version mismatch."
|
|
}
|
|
],
|
|
"architecture_reference": {
|
|
"primary_precedent": "conductor/tracks/nagent_review_20260608/ (verdict taxonomy + section structure borrowed from report.md and v2.3)",
|
|
"secondary_precedent": "conductor/tracks/fable_review_20260617/ (cross-cutting findings pattern borrowed; cluster sub-agent dispatch NOT used)",
|
|
"sibling_references": [
|
|
"conductor/tracks/intent_dsl_survey_20260612/ (named by user as sibling)",
|
|
"conductor/tracks/fable_review_20260617/ (sibling review track)",
|
|
"conductor/tracks/nagent_review_20260608/ (sibling review track)"
|
|
],
|
|
"blocked_by_track": "conductor/tracks/chronology_20260619/ (per user directive)",
|
|
"agent_directive_files_evaluated": [
|
|
"AGENTS.md (root)",
|
|
"conductor/*.md (7 files)",
|
|
"conductor/code_styleguides/*.md (11 files)",
|
|
".opencode/agents/*.md (6 files; legacy from Gemini CLI era)",
|
|
".opencode/commands/*.md (9 files; legacy)",
|
|
"docs/*.md excluding superpowers/ (~16,000 lines across 40+ files)",
|
|
".agents/skills/*.md (5 files; current MMA skills)"
|
|
],
|
|
"subject_of_review": "C:\\Users\\Ed\\.cache\\opencode\\packages\\superpowers@git+https_\\github.com\\obra\\superpowers.git\\node_modules\\superpowers\\skills\\ (14 skills)",
|
|
"styleguides": [
|
|
"conductor/code_styleguides/feature_flags.md (delete-to-turn-off; this track is research-only, so no feature flag needed)"
|
|
]
|
|
},
|
|
"deferred_to_followup_tracks": [
|
|
{
|
|
"title": "Deferred agent-directive rebuild (consolidates superpowers review + nagent review + fable review + intent_dsl_survey recommendations)",
|
|
"description": "Per the user's framing (2026-06-19), the actual conservative changes become a deferred rebuild track (parallel to the nagent_review's deferred rebuild, scheduled 1-2 weeks out per the fable_review spec). This track's decisions.md is one input to that rebuild.",
|
|
"track_status": "not requested"
|
|
},
|
|
{
|
|
"title": "Migration of docs/superpowers/specs/*.md to conductor/tracks/<id>/spec.md (if user adopts conductor convention in rebuild)",
|
|
"description": "If the deferred rebuild decides to consolidate the dual-convention by adopting the conductor convention, the existing 20 docs/superpowers/specs/*.md files would need to be migrated. That migration is a separate track.",
|
|
"track_status": "not requested"
|
|
},
|
|
{
|
|
"title": "Removal of legacy .opencode/ and .gemini/ directories (if user adopts single convention)",
|
|
"description": "If the deferred rebuild decides the project should use only .agents/skills/ (not .opencode/agents/ or .gemini/skills/), the legacy directories would need to be cleaned up. That cleanup is a separate track.",
|
|
"track_status": "not requested"
|
|
}
|
|
],
|
|
"regressions_and_pre_existing_failures": [],
|
|
"pre_existing_failures_remaining": [],
|
|
"user_directives": [
|
|
"Research-only track (user Q1 = A): no src/, tests/, or agent-directive changes. Recommendations go in decisions.md for the deferred rebuild.",
|
|
"Track occurs after chronology_20260619 (per user 2026-06-19): blocked_by chronology_20260619.",
|
|
"Siblings to nagent_review_20260608, fable_review_20260617, intent_dsl_survey_20260612 (per user 2026-06-19).",
|
|
"Follow conductor convention (user Q4 = A): all artifacts at conductor/tracks/superpowers_review_20260619/.",
|
|
"Report similar to nagent (user 2026-06-19): one section per skill, nagent-style verdicts.",
|
|
"Hybrid verdict taxonomy (user Q5 = C): primary nagent-style + secondary integration tag.",
|
|
"User framing (2026-06-19): 'conservative changes incrementally to improve AI performance and quality standards of output. I'm not after speed, pure discipline, high grade inference, good tool use, and careful text generation.'",
|
|
"Review C mostly plus anything else noticed (user 2026-06-19): superpowers plugin + project MMA skills + dual-convention + cross-cutting AI-directive observations.",
|
|
"No day estimates per conductor/workflow.md Tier 1 Track Initialization Rules (added 2026-06-16). Scope measured in files/sites only."
|
|
]
|
|
}
|