8Dionysus/aoa-decision-correct
skills/core/engineering/aoa-decision-correct/SKILL.md
--- name: aoa-decision-correct scope: core status: evaluated summary: Correct, supersede, or reindex AoA decision records by editing source notes first, rebuilding repo-local indexes, and refreshing the workspace decision graph. invocation_mode: explicit-preferred technique_dependencies: - AOA-T-0001 - AOA-T-0033 - AOA-T-0002 --- # aoa-decision-correct ## Intent Use this skill to repair an existing decision record, its index metadata, supersession links, source-surface list, or generate
$ install --global
skillsauthnpx skillsauth add 8Dionysus/aoa-skills aoa-decision-correctInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 5, 2026, 4:29 AM131.0s4 files scanned
SKILL.md
- name:
- aoa-decision-correct
- scope:
- core
- status:
- evaluated
- summary:
- Correct, supersede, or reindex AoA decision records by editing source notes first, rebuilding repo-local indexes, and refreshing the workspace decision graph.
- invocation_mode:
- explicit-preferred
aoa-decision-correct
Intent
Use this skill to repair an existing decision record, its index metadata, supersession links, source-surface list, or generated decision indexes without letting the workspace graph become the authority.
Trigger boundary
Use this skill when:
- a decision record is stale, incomplete, misindexed, wrongly sourced, or needs supersession
- generated decision indexes are out of date with source metadata
- graph lookup shows a mismatch that must be verified against the source note
- a correction must preserve local decision-lane law and validation
Do not use this skill when:
- the task is only to find relevant rationale; use
aoa-decision-find - a new durable decision is required instead; use
aoa-decision-create - the source surface itself is wrong and no decision-lane change is needed
- a generated graph or index can be refreshed without source-note drift
- the correction would rewrite history instead of adding an explicit supersession or status change
Inputs
- target decision ID, path, source surface, stale index, or graph mismatch
aoa_decisionsstatus, issues, decision, changed-path, source-surface, owner-surface, or repo packet for the target record when available- repo-local decision route card, template, source note, and generated indexes
- source files changed by the correction when relevant
- validation commands for decision indexes and affected surfaces
Outputs
- corrected source decision note or explicit no-change finding
- regenerated repo-local decision indexes when metadata changed
- refreshed or checked workspace graph
- clear report of old mismatch, correction, validation, and any remaining risk
Procedure
- use
aoa_decisionsstatus and issues first, then fetch the target decision, changed-path, source-surface, owner-surface, or repo packet when available - if graph issues exist for the target repo, classify whether the fix belongs to the source note, local index contract, workspace graph registry, or cache refresh
- read the source decision note before editing anything
- read the repo-local decision route card and generated index contract
- classify the correction as metadata, source-surface list, status, supersession, typo-only, or generated-index drift
- edit the source note first; use explicit supersession or status language for semantic changes instead of silent history rewrite
- regenerate repo-local decision indexes when metadata or source-record shape changed
- run the repo-local decision validator/check and any affected surface validator
- refresh or check the workspace graph, run the decision-graph lane when available, and compare the corrected graph packet
- report whether the graph, source note, and local indexes are now aligned
Contracts
- source notes are edited before generated indexes or graph cache
- generated graph/cache refresh cannot be used to hide source drift
- semantic corrections must preserve reviewable history through status or supersession
- typo-only fixes should not inflate into new rationale
- validation must cover the owner repo, not only the workspace graph
- graph issue packets are triage inputs; they do not replace source-note or local-contract inspection
Risks and anti-patterns
- fixing only generated indexes while leaving source metadata wrong
- changing meaning silently without status or supersession
- broad rewriting because a small metadata fix was requested
- trusting a stale graph packet after editing source files
- applying another repo's metadata vocabulary where it does not fit
- clearing cache freshness while leaving an unknown decision-lane surface unmodeled
Verification
- confirm the source note was inspected and, if needed, edited
- confirm generated indexes were regenerated only from source metadata
- confirm repo-local decision checks passed or failures are explicit
- confirm workspace graph refresh/check and decision-graph lane see the corrected state
- confirm semantic rewrites are avoided or made explicit through supersession/status
Technique traceability
Manifest-backed techniques:
- AOA-T-0001 from
8Dionysus/aoa-techniquesatcd276f040d55d490bd015b8698c7a5d594b9f875using pathtechniques/execution/agent-workflows-core/plan-diff-apply-verify-report/TECHNIQUE.mdand sections: Intent, When to use, Inputs, Outputs, Core procedure, Contracts, Risks, Validation - AOA-T-0033 from
8Dionysus/aoa-techniquesat3b1d5d623569aa4920b87280d0db0e911d2e29d5using pathtechniques/instruction/docs-boundary/decision-rationale-recording/TECHNIQUE.mdand sections: Intent, When to use, When not to use, Inputs, Outputs, Core procedure, Contracts, Risks, Validation - AOA-T-0002 from
8Dionysus/aoa-techniquesatcd276f040d55d490bd015b8698c7a5d594b9f875using pathtechniques/instruction/docs-boundary/source-of-truth-layout/TECHNIQUE.mdand sections: Intent, When to use, Inputs, Outputs, Core procedure, Contracts, Risks, Validation
Adaptation points
- repo-specific supersession/status vocabulary
- repo-local generated index commands
- decision validator and affected surface validator
- MCP refresh command or graph fallback
Related Skills
8Dionysus/aoa-decision
testing
VerifiedTrustedCommunity
--- name: aoa-decision scope: core status: evaluated summary: Route AoA decision-lane work through the workspace decision graph first, then hand off to the smallest find, create, or correct subskill while keeping repo-local decision files authoritative. invocation_mode: explicit-preferred technique_dependencies: - AOA-T-0033 - AOA-T-0002 --- # aoa-decision ## Intent Use this skill as the front door for AoA `docs/decisions/` work. It decides whether the task is to find, create, or correct
4SKILL.mdUpdated Jun 5, 2026
8Dionysus/aoa-decision-find
testing
VerifiedTrustedCommunity
--- name: aoa-decision-find scope: core status: evaluated summary: Find AoA decision records through the workspace graph, then verify claims against repo-local source notes and generated decision indexes. invocation_mode: explicit-preferred technique_dependencies: - AOA-T-0002 --- # aoa-decision-find ## Intent Use this skill to find decision rationale quickly across AoA repositories while keeping final claims grounded in the owning repository's authored decision note. ## Trigger boundary
4SKILL.mdUpdated Jun 5, 2026
8Dionysus/aoa-decision-create
tools
VerifiedTrustedCommunity
--- name: aoa-decision-create scope: core status: evaluated summary: Create a new AoA decision record in the owning repository by using graph context for placement and repo-local decision law for the actual source note and indexes. invocation_mode: explicit-preferred technique_dependencies: - AOA-T-0033 - AOA-T-0002 --- # aoa-decision-create ## Intent Use this skill when a real structural, workflow, tooling, source/export, or authority decision needs a durable repo-local `docs/decisions/`
4SKILL.mdUpdated Jun 5, 2026
8Dionysus/aoa-memo-writeback
testing
VerifiedTrustedCommunity
--- name: aoa-memo-writeback scope: core status: scaffold summary: Turn session evidence, landed-work context, and owner routes into one explicit memo writeback decision, local memo candidate, export packet, or no-writeback stop line without treating session history as reviewed memory. invocation_mode: explicit-preferred technique_dependencies: - AOA-T-0026 - AOA-T-0106 - AOA-T-0076 --- # aoa-memo-writeback ## Intent Use this skill to decide whether a live session, closeout, landed chan
3SKILL.mdUpdated May 26, 2026