ariffazil/AGI-skill-unification

Skill Unification — AAA Catalog × Harness Views

Iron rule

AAA is the catalog. Harnesses are views.
Doctrine bodies may live under /root/AAA/skills or /root/.agents/skills (doctrine_core).
Do not invent a second Grok-only catalog.

Always load first (BOOT gate)

AAA/skills/BOOTSTRAP_MANIFEST.json — 9 universals (substrate + knowledge) through READY, then domain skills.

Canonical artifacts (AAA)

| Artifact | Path | |----------|------| | Alias table (63/63) | /root/AAA/skills/SKILL_ALIAS_TABLE.json | | Mesh sync | /root/AAA/skills/scripts/skill-mesh-sync.sh | | V3 registry | /root/AAA/skills/FEDERATED_SKILLS_REGISTRY_V3.yaml | | Meta atlas | meta-mesa-skill-atlas (this organ’s sister skill) | | Complete receipt | /root/AAA/skills/docs/SKILL-UNIFICATION-COMPLETE-2026-07-12.md | | Hermes bridge | /root/A-FORGE/forge_work/2026-07-12/HERMES-V3-DOMAIN-BRIDGE.md |

Resolve a V3 short name

python3 -c "import json;d=json.load(open('/root/AAA/skills/SKILL_ALIAS_TABLE.json'));
print([a for a in d['aliases'] if a['v3_name']=='meta-atlas'][0])"

Prefer primary_path / primary_resolved. Never invent paths from short names alone.

Mesh hygiene

# dry-run
bash /root/AAA/skills/scripts/skill-mesh-sync.sh
# apply missing links (Grok natives preserved)
bash /root/AAA/skills/scripts/skill-mesh-sync.sh --apply
# CI / pre-seal
bash /root/AAA/skills/scripts/skill-mesh-sync.sh --check

Harnesses synced: ~/.grok/skills, ~/.claude/skills, ~/.codex/skills.

Grok native keepers (not AAA bodies)

arif-governed-autonomous-execution · grok-zen-aaa-substrate · grok-federation-skill-upgrader · orthogonal-skill-update · create-skill · check-work · help · imagine

Pruned: docx pptx xlsx code-review → ~/.grok/skills/.deprecated/

Pre-seal checklist

1. skill-mesh-sync.sh --check exit 0
2. Alias resolved == v3_mapped == 63 and unresolved == []
3. No live TOMBSTONE.json on V3 primaries (use RESTORED_LIVE.json if re-hydrated)
4. Grok office skills not live top-level
5. meta-mesa §0 matches live maturity

Agent Spawning — Pre-Seal Audit Protocol

Every AAA agent now declares spawnAgents: true in its agent-card.json. This enables any agent to spawn subagents for parallel pre-seal audit flows.

Protocol

# Any AAA agent can spawn auditors before SEAL:
task(description="Audit X", subagent_type="auditor", prompt="...")
task(description="OPS check Y", subagent_type="ops", prompt="...")
task(description="Plan Z", subagent_type="planner", prompt="...")

# Or use forge_parallel for orchestrated multi-agent:
# forge_parallel(mode="parallel", tasks=[...], max_concurrency=3)

Spawnable agents & purpose

| Agent | Type | Audit Purpose | |-------|------|---------------| | AUDITOR | auditor | Floor compliance, constitutional audit | | OPS | ops | Operational impact, service health | | PLANNER | planner | DAG sequencing, execution planning | | EXPLORE | explore | Codebase reconnaissance | | GENERAL | general | General-purpose research |

Recursive Uncertainty Protocol (BINDING)

F13 SOVEREIGN directive — 2026-07-12 Default behaviour for all AAA agents.

The rule

If you encounter uncertainty, missing information, or anything you cannot classify confidently:

1. Detect uncertainty — acknowledge it internally
2. Spawn an independent auditor agent immediately
3. Cross-verify — compare your findings with the auditor's
4. Continue working until both you and the auditor agree

Recursive chain

If the auditor also encounters uncertainty, it must spawn a third agent. Continue recursively until confidence is high.

AGENT → uncertain? → spawn AUDITOR
  ↓                          ↓
  works              audits independently
  ↓                          ↓
  └────────── compare ───────┘
         ↓
    agree? → YES → proceed with confidence
         ↓ NO
    spawn next agent → recurse

Boundaries

• Never ask Arif questions unless it's explicitly about human intent
• Never stop early or collapse into "I don't know"
• Never return unvetted results — multi-agent confirmation required
• Always try another agent before asking a human
• Only request human input when the uncertainty IS the human's intent/decision

Pre-seal audit flow

AGENT → spawn AUDITOR + OPS + PLANNER in parallel
         ↓
         Each runs independently, returns structured report
         ↓
         AGENT collects all receipts
         ↓
         Synthesizes findings → passes to arif_judge → SEAL

Gates

• All spawned agents are bounded (time-limited, tool-limited)
• F1 AMANAH: every spawned task is reversible (no side effects on parent)
• F11 AUDIT: every spawn is logged with receipt
• F13 SOVEREIGN: irreversible SEAL still requires human ack

Companion

Load meta-mesa-skill-atlas for routing and gap detection. This skill is the ops contract for unity.