FORGE-cross-repo-doc-zen

FORGE-cross-repo-doc-zen — Federation Documentation Graph-Connect

Skill Class: Meta · Axis: Cross-Repo · ATLAS333: P9 Layer/Collapse, P22 Unity/Diversity FORGED: 2026-07-20 by FORGE (000Ω) · Updated: 2026-08-06 (de-hardcoded)

USE WHEN

• Auditing documentation across multiple federation repos
• Finding orphan markdown files anywhere in the federation
• Fixing contradictory floor names or deprecated tool references
• Creating cross-repo documentation indexes
• Mapping docs to ATLAS333 cognitive geometry
• Reducing entropy in the documentation graph

THE ZEN RULE

Delete the container, keep the signal. Before archiving, extract eurekas. Before creating, measure entropy.

CANONICAL SOT — Organ Registry

ALL repo paths and ports come from /root/AAA/federation/organs.yaml. Never hardcode them.

# Discover organ topology
python3 -c "
import yaml
with open('/root/AAA/federation/organs.yaml') as f:
    reg = yaml.safe_load(f)
for o in reg.get('organs', []):
    src = o.get('source_path', '')
    port = o.get('port', '')
    print(f'{o[\"id\"]:12s} src={src:20s} port={port}')
"

WORKFLOW

Phase 1: SCAN (per organ — paths from registry)

# Count MD files in an organ's source_path
ORG_PATH=$(python3 -c "import yaml;r=yaml.safe_load(open('/root/AAA/federation/organs.yaml'));print([o['source_path'] for o in r['organs'] if o['id']=='<ORGAN_ID>'][0])")
find "$ORG_PATH" -name "*.md" -not -path "*/.git/*" -not -path "*/node_modules/*" | wc -l

# Find wrong floor names
grep -rn "F2.*Haqq\|F3.*Shahada\|F5.*Hikmah\|F6.*Adl\|F9.*Rahmah\|F4.*Nur" --include="*.md" "$ORG_PATH" -l

# Find deprecated tool names
grep -rn "arif_judge_deliberate\|arif_vault_seal\|arif_session_init\|arif_sense_observe\|arif_mind_reason\|arif_kernel_route\|arif_forge_execute" --include="*.md" "$ORG_PATH" -l

Phase 2: FIX

# Fix floor names (batch sed)
sed -i \
  -e 's/F2.*Haqq/F2 TRUTH/g' \
  -e 's/F3.*Shahada/F3 WITNESS/g' \
  -e 's/F4.*Nur/F4 CLARITY/g' \
  -e 's/F5.*Hikmah/F5 WISDOM/g' \
  -e 's/F6.*Adl/F6 MARUAH/g' \
  -e 's/F9.*Rahmah/F9 ANTI-HANTU/g' \
  -e 's/F13.*Khalifah/F13 SOVEREIGN/g' \
  <files>

# Fix deprecated tool names
sed -i \
  -e 's/arif_judge_deliberate/arif_judge/g' \
  -e 's/arif_vault_seal/arif_seal/g' \
  -e 's/arif_session_init/arif_init/g' \
  -e 's/arif_sense_observe/arif_observe/g' \
  -e 's/arif_mind_reason/arif_think/g' \
  -e 's/arif_kernel_route/arif_route/g' \
  -e 's/arif_forge_execute/arif_forge/g' \
  <files>

Phase 3: VERIFY (per organ from registry)

# Derive organ source_path from registry for each organ ID
# Verify no deprecated tool names remain
grep -rn "arif_judge_deliberate" --include="*.md" "$ORG_PATH" | grep -v archive | grep -v forge_work | grep -v memory

# Verify no wrong floor names remain
grep -rn "F2.*Haqq\|F3.*Shahada" --include="*.md" "$ORG_PATH" | grep -v archive

# Verify all repos clean
python3 -c "
import yaml, subprocess
with open('/root/AAA/federation/organs.yaml') as f:
    reg = yaml.safe_load(f)
for o in reg.get('organs', []):
    src = o.get('source_path', '')
    if not src: continue
    r = subprocess.run(['git', '-C', src, 'status', '--porcelain'], capture_output=True, text=True)
    dirty = len(r.stdout.strip().split('\n')) if r.stdout.strip() else 0
    print(f'{o[\"id\"]}: {dirty} dirty files')
"

CURRENT FLOOR CANON (DO NOT DEVIATE)

Floor names are authoritative at /root/arifOS/GENESIS/FLOOR_TABLE.json. Read from there.

CURRENT CANONICAL TOOLS (DO NOT USE LEGACY NAMES)

FEDERATION ORGAN MAP (EXAMPLE — probe registry for truth)

Rule: The table above is illustrative. The organ registry at /root/AAA/federation/organs.yaml is authoritative. Ports and paths change — this file does NOT.

Forged: 2026-07-20 by FORGE (000Ω) · De-hardcoded: 2026-08-06 · DITEMPA BUKAN DIBERI