# Pocketto > Pocketto `4.2.2` provides local-first AI coding workflows for Claude Code and Pi. Core is useful without GitHub or Enterprise; the optional Enterprise adapter consumes durable neutral lifecycle events and owns all remote reconciliation. An opt-in Pocket Education mode turns the agent into a repository-aware mentor — the human implements, the agent teaches and reviews. The 15 skills include a 6-stage pipeline and 9 standalone skills. ## Release surfaces The schema-1 `surfaces.json` manifest defines exactly four roles: - `pi/core` — local-first Core workflows for Pi, including Education. - `pi/enterprise` — additive Enterprise adapter for Pi; requires `pi/core`. - `claude/core` — local-first Core workflows for Claude Code, including Education. - `claude/enterprise` — additive Enterprise adapter for Claude Code; requires `claude/core`. Protocol versions are independent: `CONTRACT=3`, `PIPELINE=5`, `LIFECYCLE_SCHEMA=2`, `ADAPTER_CONTRACT=2`, and `SURFACE_MANIFEST=1`. Core commits state and events locally. Core does not call `gh`, does not create GitHub resources, does not reconcile GitHub resources, does not merge pull requests, and does not close issues. Enterprise is explicit, optional, and fail-closed before remote operations. It does not auto-create a PR; `create-pr` is an explicit user-triggered recorder. Merge and issue closure remain human-controlled. ## Lifecycle and recovery All lifecycle CLI commands use `--json --contract 3`: - `pocketto-pi lifecycle transition --artifact ::: --json --contract 3` commits local state and one durable event. - `pocketto-pi lifecycle drain --json --contract 3` replays pending events in revision order without creating events. - `pocketto-pi lifecycle repair --json --contract 3` repairs lifecycle-owned projection fields only when task state is recoverable; otherwise it fails closed without changing state. - `pocketto-pi lifecycle migrate --from v3 --json --contract 3` explicitly migrates only a pristine v3 plan with no execution progress. A progressed or non-pristine v3 plan returns `PIN_V3_REQUIRED` unchanged and must finish with the v3 CLI/Enterprise pair. v3 progress is never silently converted. A v4 preflight warns for v3 installations; an unchanged v3 binary cannot warn about a future release. Mixed-major Enterprise installs fail closed while Core remains usable and pending v4 events are retained. For rollback, disable or remove the Enterprise adapter but retain Core, `lifecycle.json`, `.pocket-meta.json`, `log.json`, pending events, and remote markers. Local execution continues. Pin a faulty adapter to the last compatible v4 release, correct it, then replay the same event IDs with `lifecycle drain`; do not automatically downgrade or destructively convert v4 state. ## Education Education is local, opt-in, and independent of Enterprise. The learner owns implementation and every profile change. `pocket-init` calibrates once and stores a `## Pocket Education` block outside the regenerable project guide; later sessions reuse it. - `npx pocketto-pi edu []` reports the learner profile. - `npx pocketto-pi edu init --level = … [--file CLAUDE.md] [--reset]` initializes the profile; refuses to overwrite without `--reset`. - `npx pocketto-pi edu set --level = …` updates confirmed levels and reports more/less guidance. - Add `--json --contract 3` for the current stable envelope and handshake. ## Skills ### Pipeline - [pocket-pitching](skills/pocket-pitching/SKILL.md): explore an unformed idea. - [pocket-grinding](skills/pocket-grinding/SKILL.md): discover requirements and produce a spec. - [pocket-planning](skills/pocket-planning/SKILL.md): create a TDD execution plan. - [pocket-structuring](skills/pocket-structuring/SKILL.md): split plans into task packets. - [pocket-development](skills/pocket-development/SKILL.md): execute tasks with audits and lifecycle events. - [pocket-closing](skills/pocket-closing/SKILL.md): reconcile verdicts and close local plan state. ### Standalone - [pocket-help](skills/pocket-help/SKILL.md): route users through the skills. - [pocket-init](skills/pocket-init/SKILL.md): local project guide and optional learner calibration; no remote integration setup. - [pocket-education](skills/pocket-education/SKILL.md): the human writes the code; the agent explains, reviews, and coaches with progressive hints at a persisted per-skill depth (foundation/guided/independent). Recommends level changes; the learner decides. - [create-pr](skills/create-pr/SKILL.md): explicit Enterprise PR recorder. - [bug-hunting](skills/bug-hunting/SKILL.md): diagnose and fix confirmed bugs. - [hotfix](skills/hotfix/SKILL.md): small-to-medium changes. - [brand-design](skills/brand-design/SKILL.md): create a brand-aware design system. - [structured-research](skills/structured-research/SKILL.md): validate an assumption with evidence. ## Enterprise references - [Lifecycle contract](skills/pocket-enterprise/references/lifecycle-contract.md) - [Issue reconciliation](skills/pocket-enterprise/references/issue-reconciliation.md) - [Phase and closure reconciliation](skills/pocket-enterprise/references/phase-reconciliation.md) - [Full README](README.md) - [Changelog](CHANGELOG.md)