Back to the catalog

attacca

Attacca is a multi-agent coding orchestrator. Manager plans, Engineer builds, Security audits, you ship. Seven Specialists, one workplace.

Open source Repository Open in the app JSON README (API)

About

Attacca is a multi-agent coding orchestrator. Manager plans, Engineer builds, Security audits, you ship. Seven Specialists, one workplace.

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
adihebbalae
Origin
marketplace
Category
ferramentas
Stars
3
Last push
2026-08-15T07:19:09Z
Repository state
ativo
Language
Astro
License
NOASSERTION
Added
2026-08-30 01:48:58
Updated
2026-08-30 01:48:58
Origin id
adihebbalae/attacca/attacca

README

# Attacca

<p align="center"><em>attacca (Italian) — proceed to the next movement without pause.</em></p>

**A context-engineering toolkit for Claude Code.** Three plugins that add what the model can't provide for itself: the questions your project needs answered before building, and the gates it can't skip before shipping.

The name is the design goal. A new session, a teammate's clone, or a cloud agent should pick the work up mid-phrase — no re-explaining the project, no re-deriving decisions already made. That's what [the score and the performance](docs/CONTEXT-SCHEMA.md#score-and-performance) are for.

Attacca 4.0 ships nothing the model already knows how to do. Every artifact is either **context** (interrogation frameworks, decision records) or **verification** (hooks, audits, gates) — see [docs/DESIGN-DECISIONS.md](docs/DESIGN-DECISIONS.md).

## Install

```
/plugin marketplace add adihebbalae/Attacca
/plugin install attacca-core@attacca
/plugin install attacca-security@attacca
/plugin install attacca-init@attacca
```

Install only what you need — each plugin works standalone.

| Plugin | What it adds |
|---|---|
| **attacca-core** | Workflow skills (diagnose, tdd, code-review, quality-gate, prototype, grill-me, adversarial-debate, wrap-session, bdr-commit, more), `critic` + `researcher` subagents, token-saving read-once hook, auto-lint hook, context-budget advisory hook |
| **attacca-security** | Security-audit / supply-chain / SBOM skills, an isolated-context `security-auditor` subagent, and a hook that **blocks `git push` until a fresh clean audit exists** |
| **attacca-init** | `/interrogate` — turns "build me a webstore with stripe and auth" into structured questions (auth, payments, data, hosting, budget, non-goals) and a committed score — plus init-project, retrofit, mvp, validate-idea |

## Start a project

```bash
mkdir my-app && cd my-app && git init && claude
```

Then: install the plugins, describe what you want to build, and `/interrogate` fires on anything ambiguous. Answers become two committed files every future session (and teammate, and cloud agent) reads to orient — **a score and a performance**:

- **`CONTEXT.md`** — the score. What this is, the stack, every decision with the alternative it beat. Authoritative over every session; append-only.
- **`.attacca/focus.md`** — this performance. What's in flight, what's next, what's blocked. Rewritten every session, disposable by design.

Three rules follow, and they're the whole convention:

1. **A performance never edits the score.** `/wrap-session` rewrites `focus.md` and only *appends* to `CONTEXT.md` — and only when a decision was actually made.
2. **You can lose a performance; you can't lose the score.** Git reconstructs what changed. Nothing reconstructs what was rejected and why.
3. **When performances keep going wrong the same way, fix the score.** Corrected twice on the same point? `/wrap-session` surfaces it and proposes the amendment, so the next session doesn't need the note.

For the minimal per-project files (CLAUDE.md, AGENTS.md, CONTEXT.md + focus.md skeletons, settings.json, statusline.mjs), copy [`template/`](template/) — six small files, that's the whole footprint. `settings.json` wires the statusLine to `statusline.mjs`, which feeds attacca-core's context-watch hook so the model can see its own context/rate-limit budget and flag it instead of quietly rotting or reflex-compacting. Existing codebase? Run `/retrofit` — it migrates a pre-4.3 single-file `CONTEXT.md` for you.

## Using another tool?

`template/AGENTS.md` is the [cross-tool standard](https://agents.md) read natively by Copilot, Cursor, Codex, and 30+ agents (Claude Code loads it via the `@AGENTS.md` import in CLAUDE.md). That one file is Attacca's entire multi-tool story — the v3 per-tool ports live on the [`legacy/v3`](../../tree/legacy/v3) branch.

## Docs

- [Plugin architecture](docs/PLUGIN-ARCHITECTURE.md) — what's in each plugin and how they loop together
- [Score and performance](docs/CONTEXT-SCHEMA.md) — `CONTEXT.md` + `.attacca/focus.md`, and why they're two files
- [Migrating from v3](docs/MIGRATION-v3-to-v4.md) — state.json → CONTEXT.md, personas → subagents
- [Design decisions](docs/DESIGN-DECISIONS.md) — why 4.x looks like this

## Version

`v4.4.0` — see [CHANGELOG.md](CHANGELOG.md). v3.11.2 (the multi-tool boilerplate era) is preserved at tag `v3.11.2-final`.

---

*Built with [Attacca](https://github.com/adihebbalae/Attacca)*

More