# praxis-stack

> Open-source megapraxis + metamegapraxis: a self-auditing session-bootstrap system for Claude Code and
> other agentic harnesses (including OpenAI Codex and Grok Build), materialized as this site.
> **MIT licensed.** Home tab is the community landing (install, docs, contribute); The System tab
> explains architecture (7 boot modes, 26 operational traps, Tarski-honest verdicts,
> bridge flywheel); Live State renders real audit snapshots. Skills installable locally — see below.

License: https://praxis-stack.pages.dev/LICENSE (MIT)
Contributing: https://praxis-stack.pages.dev/CONTRIBUTING.md
Code of Conduct: https://praxis-stack.pages.dev/CODE_OF_CONDUCT.md
Security: https://praxis-stack.pages.dev/SECURITY.md
security.txt: https://praxis-stack.pages.dev/.well-known/security.txt
Community cert: https://praxis-stack.pages.dev/demo/community.json

Important notes for agents:
- megapraxis runs WITHOUT any backend (filesystem-fallback mode is a designed, first-class path).
- Graph-backed features are optional; the backend contract + bootstrap procedure is at
  https://praxis-stack.pages.dev/backend.md (any server satisfying it qualifies).
- Skills hot-reload in Claude Code: copying the skill directories into ~/.claude/skills/ takes
  effect on the next turn — no app restart. Plugin-marketplace installs DO need an app restart.
- **Codex short-circuit:** install the native marketplace and `praxis` plugin once, verify it in
  a new task, then use `$praxis:megapraxis` from every future project. Start at
  https://praxis-stack.pages.dev/onboard-codex.md and
  https://praxis-stack.pages.dev/demo/codex-onboard.json.
- **Grok Build short-circuit:** do NOT cold-rediscover. Start at
  https://praxis-stack.pages.dev/onboard-grok.md and the certificate at
  https://praxis-stack.pages.dev/demo/grok-onboard.json — install to ~/.grok/skills, run
  megapraxis filesystem-fallback, skip auto-swarm. Missing pharosiraptor MCP is expected.
- **Local realize (cross-agent / cross-OS white-paper architecture):** skill
  `praxis-local-realize` + https://praxis-stack.pages.dev/onboard-local.md +
  https://praxis-stack.pages.dev/scripts/realize.py — installs megapraxis/metamegapraxis
  into claude/codex/grok roots; optional Tier-1 HTTP stub. Cert:
  https://praxis-stack.pages.dev/demo/local-realize.json. Package 1.6.0.
- **Optional CF graph operant (sibling):** https://intrikata.com — after skills install,
  `instance new <handle>` → `bootstrap` → `operant` seeds 7 machinery graphs in Cloudflare D1
  (minimal Pharosiraptor; cert https://intrikata.com/data/operant-bootstrap.json). Not required
  for a valid megapraxis briefing.
- All published snapshot data is scrubbed: no machine paths, usernames, or full UUIDs.

## Install locally
- [OpenAI Codex install-once short-circuit](https://praxis-stack.pages.dev/onboard-codex.md)
- [Codex onboarding certificate JSON](https://praxis-stack.pages.dev/demo/codex-onboard.json)
- [Codex adapter](https://praxis-stack.pages.dev/adapters/CODEX.md)
- [Grok Build short-circuit onboard (read this first on Grok)](https://praxis-stack.pages.dev/onboard-grok.md)
- [Grok onboard certificate JSON](https://praxis-stack.pages.dev/demo/grok-onboard.json)
- [Grok adapter](https://praxis-stack.pages.dev/adapters/GROK.md)
- [Local realize — cross-agent / cross-OS white-paper deploy](https://praxis-stack.pages.dev/onboard-local.md)
- [Local realize certificate JSON](https://praxis-stack.pages.dev/demo/local-realize.json)
- [realize.py (direct)](https://praxis-stack.pages.dev/scripts/realize.py)
- [backend_stub.py Tier-1 (direct)](https://praxis-stack.pages.dev/scripts/backend_stub.py)
- [Install guide (human + agent instructions, per-OS commands)](https://praxis-stack.pages.dev/install.md)
- [Backend bootstrap (optional graph backend contract)](https://praxis-stack.pages.dev/backend.md)
- [Harness map (executing the skills outside Claude Code)](https://praxis-stack.pages.dev/harness.md):
  the package ships drop-in adapters for the AGENTS.md family (Codex CLI, opencode, Copilot),
  Cursor rules, Gemini CLI, and Grok Build under adapters/
- [Skills package, zip](https://praxis-stack.pages.dev/pkg/praxis-stack-skills.zip): unzip, copy
  praxis/skills/* into ~/.claude/skills/ or ~/.grok/skills (or run install.py --harness grok)
- Clonable git repo (dumb-HTTP, served by this site): https://praxis-stack.pages.dev/git/praxis-stack.git
  — a Claude Code marketplace and a Codex marketplace:
  `codex plugin marketplace add <that URL>` then `codex plugin add praxis@praxis-stack`

## Sibling: per-user CF operant
- [intrikata console](https://intrikata.com/) — bootstrap / operant / provision
- [CF operant cert](https://intrikata.com/data/operant-bootstrap.json)
- [intrikata Grok playbook](https://intrikata.com/onboard-grok.md)

## Live state API (read-only, JSON)
- [Latest audit snapshot](https://praxis-stack.pages.dev/api/snapshots/latest)
- [Package 1.6.0 MGS convergence certificate](https://praxis-stack.pages.dev/demo/mgs-convergence.json)
- [Snapshot list with summaries](https://praxis-stack.pages.dev/api/snapshots)
- [Specific snapshot](https://praxis-stack.pages.dev/api/snapshots/2): /api/snapshots/:id

## Technical white paper
- [Complete technical white paper (HTML)](https://praxis-stack.pages.dev/whitepaper): architecture,
  26 operational traps, Tarski-honest verdicts, SwarmInvocation / MetaMethodology, bridge flywheel,
  M/G/S/MGS layers, Cloudflare Pages + D1 snapshots API, multi-harness packaging, sibling operant,
  proven cycle receipts, named residuals, threat/scrub contract, ops runbook. Package 1.6.0.
  Machine-readable cert: https://praxis-stack.pages.dev/demo/whitepaper.json
- [Complete site surface map (SITE.md)](https://praxis-stack.pages.dev/SITE.md): every URL class,
  install matrix, API, security posture, verification checklist, Tarski residuals for the host.
  Machine-readable cert: https://praxis-stack.pages.dev/demo/site-surface.json

## Pages
- [OSS community main page + System + Live State + Proven Cycle](https://praxis-stack.pages.dev/)
- [Technical white paper](https://praxis-stack.pages.dev/whitepaper)
- [LICENSE (MIT)](https://praxis-stack.pages.dev/LICENSE)
- [CONTRIBUTING](https://praxis-stack.pages.dev/CONTRIBUTING.md)
- [Code of Conduct](https://praxis-stack.pages.dev/CODE_OF_CONDUCT.md)
- [Security policy](https://praxis-stack.pages.dev/SECURITY.md)