Agent Skills: arif-init-wrapper

Universal session auto-anchor for ALL agent vendors on arifOS VPS — Codex, Claude, Gemini, Kimi, OpenCode, Aider, Copilot, and future agents

UncategorizedID: ariffazil/arifOS/arif-init-wrapper

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ariffazil/arifos/tree/HEAD/skills/arif-init-wrapper

Skill Files

Browse the full folder contents for arif-init-wrapper.

Download Skill

Loading file tree…

skills/arif-init-wrapper/SKILL.md

Skill Metadata

Name
arif-init-wrapper
Description
Universal session auto-anchor for ALL agent vendors on arifOS VPS — Codex, Claude, Gemini, Kimi, OpenCode, Aider, Copilot, and future agents

arif-init-wrapper

P0 — Universal Anchor for All Agent Vendors Seal: DITEMPA BUKAN DIBERI · 2026-03-27


Purpose

Every agent on this VPS starts from the same broken state: no anchor, no session context, no constitutional grounding. The arif-init-wrapper closes this gap for every vendor by providing a universal bootstrap that:

  1. Establishes a governed session via arifOS MCP
  2. Verifies the agent's identity context
  3. Checks constitutional floor health before any tool is touched
  4. Reads carry-forward context from memory before starting work
  5. Reports its status to the operator in plain language

Why this is P0: Without this, agents operate unanchored — the exact condition that produced the opencode catastrophe (session with no constitutional grounding, leading to blind git reset --hard origin/main).


Trigger Patterns

Every time any of these agents start a session, run arif-init-wrapper:

| Agent | Invocation | |-------|-----------| | Claude Code | On every claude session start | | Codex | On every codex session start | | Gemini CLI | On every gemini session start | | Kimi | On every kimi session start | | OpenCode | On every opencode session start | | Aider | On every aider session start | | Copilot CLI | On every github-copilot-cli session start | | Any new agent | On first boot, before any tool use |


Protocol

Step 1 — Anchor Session

# Probe arifOS MCP availability
curl -sf http://localhost:8080/health 2>/dev/null && {
  # Session anchor via MCP
  arifosmcp_call tool=init_anchor payload='{"actor_id":"AGENT","session_purpose":"WORK"}'
} || {
  echo "[UNANCHORED] arifOS MCP unavailable. Operating WITHOUT constitutional grounding."
  echo "[WARNING] This is high-risk. Proceed with extreme caution."
}

Step 2 — Constitutional Integrity Check (LAW 2)

Before any work, verify the foundation:

# Check core directory integrity
core_modules=$(ls /root/arifosmcp/core/*.py 2>/dev/null | wc -l)
if [ "$core_modules" -lt 10 ]; then
  echo "[P0 CONSTITUTIONAL CRISIS] /root/arifosmcp/core/ appears broken ($core_modules modules, expected 20+)"
  echo "[ACTION] HALT. Report to Arif. Do not proceed."
  echo "[RECOVERY] Check feature branches: git branch -a | grep feature/"
  return 1 2>/dev/null || exit 1
fi

# Check pytest can collect tests (structural sanity)
cd /root/arifosmcp && pytest --collect-only -q 2>/dev/null | tail -1 && {
  echo "[OK] Constitutional structure verified."
} || {
  echo "[WARNING] pytest collection failed. Foundation may be unstable."
}

Step 3 — Check Floors (F1–F13 baseline)

# Verify critical floors are loadable
python3 -c "
import sys
sys.path.insert(0, '/root/arifosmcp')
try:
    from core.shared.floors import THRESHOLDS
    floors_ok = len(THRESHOLDS) >= 13
    print(f'[FLOORS] {len(THRESHOLDS)}/13 loaded')
except Exception as e:
    print(f'[FATAL] Floor check failed: {e}')
    sys.exit(1)
"

Step 4 — Memory Carry-Forward

# Query recent scars and unresolved issues
arifosmcp_call tool=memory_query payload='{"query":"recent scars unresolved actions","limit":5}'

Step 5 — Agent Identity Declaration

State clearly:

  • Which agent vendor is running
  • Whether constitutional grounding is active or unavailable
  • Any constitutional warnings for this session

Step 6 — Operator Report

Report to Arif in plain language:

[ANCHOR] Agent: {vendor}
[STATUS] arifOS MCP: {available/unavailable}
[FLOORS] Constitutional check: {pass/wail}
[CORE]   Core modules: {count}/expected
[MEMORY] Recent context: {carry_forward_summary}
[RISK]   Session risk level: {LOW/MEDIUM/HIGH/CRITICAL}
[ACTION] Ready to proceed: YES/NO

Decision Matrix

| arifOS MCP | Core OK | pytest OK | Floors OK | Action | |-----------|---------|-----------|-----------|--------| | ✅ | ✅ | ✅ | ✅ | Proceed normally | | ✅ | ✅ | ✅ | ⚠️ | Proceed with floor warnings | | ✅ | ⚠️ | ✅/⚠️ | ✅ | HALT — P0 Foundational Crisis | | ✅ | ❌ | ❌ | ❌ | HALT — full corruption | | ❌ | ✅ | ✅ | ✅ | HIGH RISK — proceed with extreme caution, log everything | | ❌ | ⚠️/❌ | ⚠️/❌ | ⚠️/❌ | CRITICAL — HALT, report to Arif immediately |


Anti-Patterns This Closes

  1. Unanchored Codexcodex runs without session context, blunders into git reset --hard
  2. Ungrounded Geminigemini assumes origin/main is good without checking
  3. Skip-before-check — Any agent that runs git pull before verifying the repo is structurally sound
  4. Silent failure — Agent operates in a broken state without telling Arif

Constitutional Alignment

| Floor | How Enforced | |-------|--------------| | F1 Amanah | Reversibility checked before any destructive git op | | F2 Truth ≥0.99 | Uncertainty bands declared in operator report | | F7 Humility [0.03–0.05] | Explicit confidence level in session status | | F11 CommandAuth | Protected identities require cryptographic proof | | F13 Sovereign | All HALT states require Arif's explicit decision to proceed |


arif-init-wrapper — Forged 2026-03-27 · DITEMPA BUKAN DIBERI · Universal Agent Anchor 🔐