# Local realize — white-paper architecture on this machine

**Audience:** any agent or human deploying the praxis-stack architecture **locally**
across OSes (Windows / macOS / Linux) and harnesses (Claude Code, Codex, Grok Build,
AGENTS.md family).

**Live:** https://praxis-stack.pages.dev/onboard-local.md  
**White paper:** https://praxis-stack.pages.dev/whitepaper  
**Certificate template:** https://praxis-stack.pages.dev/demo/local-realize.json  
**Skill:** `praxis-local-realize`  
**Scripts:** https://praxis-stack.pages.dev/scripts/realize.py ·
https://praxis-stack.pages.dev/scripts/backend_stub.py

## MetaMethodology / SwarmInvocation

```
SwarmInvocation::inv-mmgp-20260718-local-realize
  ::source=praxis-local-realize
  ::class=local-whitepaper-realize
  ::verdict=converged-modulo-harness
  ::cross_os=windows,darwin,linux
  ::cross_agent=claude,codex,grok,agents.md
  ::tier0=skills-filesystem-fallback
  ::tier1=optional-http-stub
  ::tier2=optional-full-graph-mcp-not-auto
  ::package_url=https://praxis-stack.pages.dev/pkg/praxis-stack-skills.zip
```

## What “realized” means

| Tier | What is on disk / running | Valid briefing? |
|---|---|---|
| **0** | `megapraxis` + `metamegapraxis` (+ `praxis-local-realize`) in harness skill root(s) | **Yes** (`_via: filesystem_`) |
| **1** | Tier 0 + HTTP stub on `127.0.0.1:8080` matching BACKEND.md shapes | Yes; graph footer still filesystem until MCP |
| **2** | Full GraphDoc + MCP (`megapraxis_boot`, …) | Optional; not auto-installed by realize |

## One-shot (recommended)

### Windows (PowerShell)

```powershell
iwr https://praxis-stack.pages.dev/scripts/realize.py -OutFile realize.py
iwr https://praxis-stack.pages.dev/scripts/backend_stub.py -OutFile backend_stub.py
# Tier 0 — all harnesses
py -3 realize.py --harness all --tier 0 --force
# Optional Tier 1
py -3 realize.py --harness all --tier 1 --backend-dir .\praxis-backend --start-backend --force
```

### macOS / Linux

```bash
curl -sL https://praxis-stack.pages.dev/scripts/realize.py -o realize.py
curl -sL https://praxis-stack.pages.dev/scripts/backend_stub.py -o backend_stub.py
python3 realize.py --harness all --tier 0 --force
# Optional Tier 1
python3 realize.py --harness all --tier 1 --backend-dir ./praxis-backend --start-backend --force
```

### From the skills package

```text
curl -sL https://praxis-stack.pages.dev/pkg/praxis-stack-skills.zip -o praxis.zip
# unpack, then:
py -3 scripts/realize.py --harness all --tier 0 --force     # Windows
python3 scripts/realize.py --harness all --tier 0 --force   # POSIX
# or classic:
py -3 install.py --harness claude --force
```

## Agent path (self-realizing skill)

1. If `praxis-local-realize` is not installed, fetch the zip or this playbook and run `realize.py`.
2. Execute the skill procedure (or the script — same pipeline).
3. Verify disk: `megapraxis/SKILL.md` and `metamegapraxis/SKILL.md` under target roots, size > 1KB.
4. Run `/megapraxis` (or harness equivalent). Do **not** auto-dispatch a self-audit swarm.
5. Keep the cert at `./.praxis-realize/local-realize.cert.json`.

## Cross-agent notes

| Harness | After realize |
|---|---|
| Claude Code | Skills hot-reload; `/megapraxis` next turn |
| Codex | Prefer plugin marketplace once; disk skills are fallback — new task to verify registry |
| Grok Build | `/megapraxis` filesystem-fallback; traps #4/#5 N/A unless graph requested |
| Cursor / Gemini / AGENTS.md | Point adapters at package `praxis/skills/` + HARNESS.md |

## Verify only

```text
py -3 realize.py --harness all --verify-only
python3 realize.py --harness all --verify-only
```

## Residuals (named)

- Full Tier 2 Pharosiraptor/MCP is **not** self-realized by this path (undecidable auto-portability of origin backends).
- Plugin marketplace registration ≠ disk install (trap #2 / #3).
- HTTP stub ≠ `_via: graph_` without MCP (by design).
- Offline machines need a pre-supplied zip (`INCOMPLETE (package unreachable)` if fetch fails).

## Related

- https://praxis-stack.pages.dev/install.md
- https://praxis-stack.pages.dev/backend.md
- https://praxis-stack.pages.dev/harness.md
- https://praxis-stack.pages.dev/onboard-codex.md
- https://praxis-stack.pages.dev/onboard-grok.md