# Install and use ContextJoin in this project

ContextJoin is a Markdown-first project memory and live agent-coordination layer. The user-facing handbook lives in `.project-context/views/*.md`. Structured metadata exists only to compile, review, synchronize, and protect that Markdown memory.

Set it up in the current project:

1. Detect whether this harness is Codex, Claude Code, Cursor, or another Agent Skills-compatible harness.
2. Run `curl -fsSL https://contextjoin.hitroo.com/install.sh | sh -s -- <codex|claude|cursor|generic> .`. This installs the skill and completes project setup in one command. It safely skips work that is already complete.
3. Read the installed `project-context-ledger` skill completely and follow it.
4. For an existing project, inspect repository instructions, README files, manifests, architecture documents, and current Git state. Propose only a small evidence-backed initial memory. Leave every proposal pending for human review.

Operating contract:

- Before material work, load a task-specific brief and list active work.
- Publish a short leased work checkpoint containing only the objective, intended paths, touched files, branch, device, harness, and meaningful coordination notes.
- Treat live work as ephemeral. Never turn it into project truth or an activity-surveillance stream.
- Propose only durable facts, decisions, pivots, milestones, risks, open questions, and handoffs that will help a future agent work correctly.
- Never store prompts, raw conversations, hidden reasoning, command output, source code, diffs, credentials, or secrets in ContextJoin.
- Approved context becomes the shared Markdown handbook. Pending proposals never appear as confirmed truth.
- Git remains responsible for source code and diffs. ContextJoin is responsible for structured project memory and agent coordination.