docs: update README and planning docs for new workflow

- Add ccc:record, ccc:clean, ccc:reset, check:full to Developer Scripts
- Replace clone URL placeholder with actual repo URL
- Use pnpm ccc:clean instead of manual rm for redo instructions
- Update planning docs: Claude → AI Coworker, ccc:nuke → ccc:clean/reset,
  remove scripts/ section, add ccc:status command
- Reformat markdown tables

Author: phroi

.planning/codebase/CONVENTIONS.md

@@ -5,7 +5,7 @@
 ## Important Context
 
 **Tooling:**
-- `gh` CLI is NOT available and must NOT be installed. Use `pnpm pr` to open PRs and `pnpm review` to fetch PR comments.
+- `gh` CLI is NOT available and must NOT be installed. PR and review workflows are handled inline by the AI Coworker (see AGENTS.md).
 
 **Legacy vs. New code:**
 - `@ickb/lumos-utils@1.4.2` and `@ickb/v1-core@1.4.2` are **LEGACY and DEPRECATED** npm packages. The apps (`apps/bot`, `apps/tester`, `apps/interface`) still depend on them.

.planning/codebase/STACK.md

@@ -101,11 +101,11 @@ The repo supports using a local development build of CCC for testing unpublished
 **`ccc-dev/record.sh`:**
 - Clones the CCC repo (`https://github.com/ckb-devrel/ccc.git`) into `./ccc-dev/ccc/`
 - Accepts refs as args: branch names, PR numbers, or commit SHAs
-- Merges specified refs onto a `wip` branch (uses Claude CLI for merge conflict resolution)
+- Merges specified refs onto a `wip` branch (uses AI Coworker CLI for merge conflict resolution)
 - Builds CCC locally: `pnpm build:prepare && pnpm build`
 - Run via: `pnpm ccc:record` (default invocation: `bash ccc-dev/record.sh releases/next releases/udt`)
 - The `ccc-dev/ccc/` directory is gitignored
-- Skips if `ccc-dev/ccc/` already exists (remove it to redo setup)
+- Aborts if `ccc-dev/ccc/` has pending work (uncommitted changes or unpushed commits)
 
 **`.pnpmfile.cjs`:**
 - A pnpm `readPackage` hook that auto-discovers all packages in `ccc-dev/ccc/packages/*/package.json`

.planning/codebase/STRUCTURE.md

@@ -73,7 +73,7 @@
 │   │   ├── REFS                    # Pinned branch HEADs
 │   │   └── resolutions/            # Merge conflict resolutions
 │   ├── ccc/                        # Gitignored: ephemeral CCC clone (auto-generated)
-│   ├── record.sh                   # Records new pins with Claude conflict resolution
+│   ├── record.sh                   # Records new pins with AI Coworker conflict resolution
 │   ├── replay.sh                   # Deterministically rebuilds ccc/ from pins
 │   └── tsc.mjs                     # TypeScript compilation script override
 ├── contracts/                      # Reference: Rust on-chain contracts (git-ignored, clone via `pnpm reference`)
@@ -345,19 +345,15 @@
 - System: Record/replay mechanism for deterministic, conflict-free builds
 - `pins/`: Committed directory containing:
   - `REFS`: Pinned branch HEADs for merging
-  - `resolutions/`: Serialized conflict resolutions with Claude aid
+  - `resolutions/`: Serialized conflict resolutions with AI Coworker aid
 - `ccc/`: Generated from pins; auto-deleted and rebuilt on `pnpm install`
 - Activation: `.pnpmfile.cjs` hook triggers `replay.sh` and overrides package resolution
 - Commands:
-  - Record: `pnpm ccc:record releases/next releases/udt` (requires Claude CLI)
+  - Record: `pnpm ccc:record releases/next releases/udt` (requires AI Coworker CLI)
+  - Status: `pnpm ccc:status` (check for pending work in `ccc/`)
   - Rebuild: `pnpm install` (automatic)
-  - Clean: `pnpm ccc:nuke && pnpm install`
-
-**scripts/:**
-- Purpose: Developer convenience scripts
-- Files: `pr.sh` (GitHub PR creation), `review.sh` (fetch PR comments)
-- Execution: Via `pnpm pr` and `pnpm review` shortcuts
-- Committed: Yes
+  - Clean (re-replay): `pnpm ccc:clean && pnpm install` (guarded)
+  - Reset (published): `pnpm ccc:reset && pnpm install` (guarded)
 
 **node_modules/:**
 - Purpose: Installed npm/pnpm dependencies

AGENTS.md

@@ -6,8 +6,10 @@ This file is the tool-agnostic agent config:
 - Never add AI tool attribution or branding to PR descriptions, commit messages, or code comments (e.g. "Generated with ...", "Built by ...", "Powered by ...").
 - Refer to yourself as "AI Coworker" in docs and comments, not by product or company name.
 - Do not install or use `gh` CLI.
-- **Open a PR**: Push the branch, then construct and present a GitHub compare URL
-  (`quick_pull=1`) to the user. Base branch is `master`. Prefill "title" (concise, under 70 chars) and "body" (markdown with ## Why and ## Changes sections). Be brief.
+- **Open a PR**: Push the branch, then open a GitHub compare URL (`quick_pull=1`)
+  in the browser via `"$BROWSER" '<url>'`. Base branch is `master`. Prefill
+  "title" (concise, under 70 chars) and "body" (markdown with ## Why and
+  ## Changes sections). Be brief.
 - **Fetch PR review comments**: Use the GitHub REST API via curl.
   Fetch all three comment types (issue comments, reviews, and inline comments).
 

README.md

@@ -8,23 +8,23 @@ This monorepo is developing the **new generation** of iCKB libraries, replacing
 
 **New packages** (under `packages/`, built on CCC):
 
-| Package | Purpose | Status |
-|---|---|---|
+| Package       | Purpose                                                                    | Status             |
+| ------------- | -------------------------------------------------------------------------- | ------------------ |
 | `@ickb/utils` | Blockchain primitives, transaction helpers, epoch arithmetic, UDT handling | Active development |
-| `@ickb/dao` | Nervos DAO abstraction layer | Active development |
-| `@ickb/order` | Limit order cell management | Active development |
-| `@ickb/core` | iCKB core protocol logic (deposits, receipts, owned owner) | Active development |
-| `@ickb/sdk` | High-level SDK composing all packages | Active development |
+| `@ickb/dao`   | Nervos DAO abstraction layer                                               | Active development |
+| `@ickb/order` | Limit order cell management                                                | Active development |
+| `@ickb/core`  | iCKB core protocol logic (deposits, receipts, owned owner)                 | Active development |
+| `@ickb/sdk`   | High-level SDK composing all packages                                      | Active development |
 
 **Apps migration status:**
 
-| App | Purpose | Stack |
-|---|---|---|
-| `apps/faucet` | Testnet CKB distribution | **Migrated** to new packages + CCC |
-| `apps/sampler` | iCKB exchange rate sampling | **Migrated** to new packages + CCC |
-| `apps/bot` | Automated order matching | Legacy (`@ickb/v1-core` + Lumos) |
-| `apps/tester` | Order creation simulator | Legacy (`@ickb/v1-core` + Lumos) |
-| `apps/interface` | React web UI | Legacy (`@ickb/v1-core` + Lumos) |
+| App              | Purpose                     | Stack                              |
+| ---------------- | --------------------------- | ---------------------------------- |
+| `apps/faucet`    | Testnet CKB distribution    | **Migrated** to new packages + CCC |
+| `apps/sampler`   | iCKB exchange rate sampling | **Migrated** to new packages + CCC |
+| `apps/bot`       | Automated order matching    | Legacy (`@ickb/v1-core` + Lumos)   |
+| `apps/tester`    | Order creation simulator    | Legacy (`@ickb/v1-core` + Lumos)   |
+| `apps/interface` | React web UI                | Legacy (`@ickb/v1-core` + Lumos)   |
 
 **Key upstream contributions:** UDT and Epoch support were contributed to CCC upstream and have been merged. Some local utilities may overlap with features now available natively in CCC.
 
@@ -58,10 +58,10 @@ graph TD;
 When `ccc-dev/pins/REFS` is committed, `pnpm install` automatically sets up the CCC local development environment on first run (by replaying pinned merges via `ccc-dev/replay.sh`). No manual setup step is needed — just clone and install:
 
 ```bash
-git clone <repo-url> && cd stack && pnpm install
+git clone git@github.com:ickb/stack.git && cd stack && pnpm install
 ```
 
-To redo the setup from scratch: `rm -rf ccc-dev/ccc && pnpm install`.
+To redo the setup from scratch: `pnpm ccc:clean && pnpm install`.
 
 See [ccc-dev/README.md](ccc-dev/README.md) for recording new pins, developing CCC PRs, and the full workflow.
 
@@ -80,12 +80,15 @@ This clones two repos into the project root (both are git-ignored and made read-
 
 ## Developer Scripts
 
-| Command | Description |
-|---|---|
-| `pnpm pr` | Open a GitHub PR creation page for the current branch. Uses Claude to auto-generate title and body when available, falls back to branch name and commit log. |
-| `pnpm review` | Fetch and display PR review comments from GitHub for the current branch (or `pnpm review -- --pr <number>` for a specific PR). |
-
-> **Note:** `gh` CLI is not available in this environment. Use `pnpm pr` and `pnpm review` instead.
+| Command             | Description                                                                           |
+| ------------------- | ------------------------------------------------------------------------------------- |
+| `pnpm coworker`     | Launch an interactive AI Coworker session (full autonomy, opus model).                 |
+| `pnpm coworker:ask` | One-shot AI query for scripting (sonnet model, stateless). Used by `pnpm ccc:record`. |
+| `pnpm ccc:status`   | Show pending work (uncommitted changes or unpushed commits) in `ccc-dev/ccc/`.        |
+| `pnpm ccc:record`   | Record CCC pins (clone, merge refs, build). Guarded against pending work.             |
+| `pnpm ccc:clean`    | Remove CCC clone, keep pins (guarded). Re-replay on next `pnpm install`.              |
+| `pnpm ccc:reset`    | Remove CCC clone and pins (guarded). Restores published CCC packages.                 |
+| `pnpm check:full`   | Wipe derived state and validate from scratch. Skips wipe if CCC has pending work.     |
 
 ## Epoch Semantic Versioning