# platform-tooling — bucket knowledge scaffold

**Bucket:** 7 of 7. Referenced from CLAUDE.md.template Bucket 7.

## What this bucket carries

Use the estate's own tooling first. Consistent, dogfooded, learnable. Tool-discovery discipline, environment awareness (`pa environment`), platform CLI reference, workspace server, scheduling, MCP servers, working-directory resolution, proactive tool proposal.

## Scope — core vs operator overlay

**In core.** Universal tooling mechanism: tool-discovery-every-session pattern, `pa environment` CLI (verbs + cache + performance constraint), `pa` / `desk` CLI references, workspace server (`pa workspace`), scheduling primitives (`schedules/<id>.json`), MCP server catalogue (discover via `--help`), working-directory resolution, proactive-tool-proposal pattern.

**In operator overlay** (`operator/knowledge/platform-tooling/`). Operator extensions listed under `operator/extensions/tools/`, operator-specific workspace port, operator's default scheduling target host, MCP servers the operator relies on.

## Canonical entries in this scaffold

| File | Purpose |
|---|---|
| `tool-discovery-discipline.md` | Every-session-boot rediscover-surface pattern. `pa --help`, `desk --help`, `ls operator/extensions/tools/`. |
| `environment-awareness.md` | `.session/environment.json` semantics + `pa environment` CLI + performance constraint + boot-instruction design choice. |
| `pa-cli-reference.md` | The `pa` bin verb overview. Points at `pa --help` as source of truth. |
| `desk-cli-reference.md` | The `desk` bin — read-only. Points at `desk --help`. |
| `workspace-server.md` | Workspace server operations. |
| `scheduling-and-launchd.md` | `schedules/<id>.json` conventions; target host is an operator-configured field. |
| `working-directory-vs-project-root.md` | cwd vs project root; how to resolve. |
| `mcp-servers-catalogue.md` | Available MCP servers, use-when-fits guidance. |

## How operators adopt this

Copy the shape into `operator/knowledge/platform-tooling/`. Populate operator extensions list, workspace port, scheduling default host, and MCP-dependency notes in the marked hooks.

## Related

- CLAUDE.md.template Bucket 7 — the rule list that references this deeper doc.
- `packages/core/docs/workspace-operations.md` — workspace reference.
- `packages/core/docs/working-directory.md` — cwd vs project root.
- `packages/core/docs/scheduling.md` — scheduling primitives.