adopt-frameworklisted
Install: claude install-skill renewisepunk/wisepunk-agentic-engineering-framework-v2
# Adopt the Wisepunk Agentic Engineering Framework
This skill takes a target repo from "no framework" to "first `/new-feature` ready" without requiring a review of the framework repo. Everything needed is in this file and its two references.
## The framework in 60 seconds
A Markdown-native operating system for directing a fleet of Claude Code agents:
- **Four-step loop** — `plan → work → review → compound` — every feature flows through it. Workflows live in `ai/workflows/`.
- **Skills** — `/new-feature <ISSUE-ID>` plans and claims an issue; `/ship-feature` validates, reviews, compounds, opens the PR. Plus `/independent-review`, `/security-review`, `/efficiency-review`.
- **Parallel isolation** — git worktrees + per-branch preview backends + per-branch ports so many agents run at once.
- **Linear is the work queue** — `tools/linear-cli.mjs` wraps the API; the assignee field is a race-safe lock.
- **Compounding knowledge** — after every feature, pitfalls/patterns/ADRs are extracted into `ai/knowledge/` so the next agent starts smarter.
- **Three-Surface Rule** — every user-facing capability reachable from UI, AI chat, and CLI/HTTP.
For the file-by-file map of everything the installer writes, read `references/framework-map.md`. Do **not** crawl the framework repo's `docs/` — they are human deep-dives; the map covers what an integrating agent needs.
## Inputs to collect first
1. **Framework source** — a local clone of this repo. If not present:
```bash
git clone http