{"id":49551227,"url":"https://github.com/amargautam/pakka","last_synced_at":"2026-05-02T22:16:24.793Z","repository":{"id":353584956,"uuid":"1219430349","full_name":"amargautam/pakka","owner":"amargautam","description":"Claude Code harness — fewer tokens, fewer bugs, audit-ready. 11 engineering skills. Apache-2.0.","archived":false,"fork":false,"pushed_at":"2026-05-02T03:24:10.000Z","size":31377,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T03:26:40.073Z","etag":null,"topics":["ai","claude","claude-code","code-quality","code-review","debugging","developer-productivity","developer-tools","llm","tdd"],"latest_commit_sha":null,"homepage":"https://pakka.dev","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amargautam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-23T21:44:41.000Z","updated_at":"2026-05-02T03:24:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/amargautam/pakka","commit_stats":null,"previous_names":["amargautam/pakka"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/amargautam/pakka","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amargautam%2Fpakka","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amargautam%2Fpakka/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amargautam%2Fpakka/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amargautam%2Fpakka/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amargautam","download_url":"https://codeload.github.com/amargautam/pakka/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amargautam%2Fpakka/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32551267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T21:31:48.061Z","status":"ssl_error","status_checked_at":"2026-05-02T21:31:46.574Z","response_time":132,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","claude-code","code-quality","code-review","debugging","developer-productivity","developer-tools","llm","tdd"],"created_at":"2026-05-02T22:16:24.085Z","updated_at":"2026-05-02T22:16:24.788Z","avatar_url":"https://github.com/amargautam.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pakka\n\nClaude Code harness — fewer tokens, fewer bugs, audit-ready. Apache-2.0.\n\n## Install\n\n```\n/plugin marketplace add amargautam/pakka-marketplace\n/plugin install pakka@pakka-marketplace\n```\n\nZero-config. Uses your existing Claude Code auth. No API key required.\n\n## Upgrade\n\n```\n/plugin marketplace update\n/plugin install pakka@pakka-marketplace\n/reload-plugins\n```\n\n`/plugin marketplace update` must run first — it pulls the latest catalog ref. Without it, install resolves to a stale cached version.\n\n## What it does\n\n\u003ca id=\"skills\"\u003e\u003c/a\u003e\n\n### 8 commands — context-inferred, discipline-driven\n\nPakka injects discipline into every session. Commands infer what you need from context — no mode flags, no guessing.\n\n| Command | Infers from | What it does |\n|---|---|---|\n| `/pakka:plan` | \"build X\", \"design\", \"challenge this\", \"probe me\", \"break into tickets\" | Design hub. Writes spec to `docs/specs/`. Routes to spec · challenge · probe · slice based on context. Never auto-chains to build. |\n| `/pakka:build` | \"implement\", \"write tests\", \"broken\", \"how does X work\", \"hard to test\" | Implementation hub. Checks for spec approval first. Routes to TDD · debug · map · audit based on context. Blocks completion claims without exit-code evidence. |\n| `/pakka:review` | \"done?\", \"ship?\", \"they said...\", \"merge?\" | Quality hub. Verifies first (exit codes), then runs reviewer + security + architect agents in parallel. Handles incoming feedback and branch landing. |\n| `/pakka:triage` | \"triage\", \"look at issue #N\", \"what needs attention\" | Issue queue. Routes bugs and features through classification state machine. Produces agent-ready briefs. |\n| `/pakka:setup` | one-time setup | Detects stack, writes permissions overlay. `setup guard` installs git guard hook. |\n| `/pakka:compress` | — | Compression control. `[lite\\|strict\\|ultra\\|super-ultra\\|status]`. Default: `super-ultra`. Hook-handled — instant, no LLM round-trip. |\n| `/pakka:recall [query]` | — | search audit trail across sessions via FTS5 index |\n| `/pakka:help` | — | Show pakka status — active level, gate config, hooks. |\n\n### Ambient disciplines (always active, no invocation needed)\n\n**Verification:** before any \"done\", \"working\", \"passing\" claim — pakka requires actual exit-code evidence. Injected at session start.\n\n**Skill-check:** before each response — pakka checks whether the message calls for `/pakka:plan`, `/pakka:build`, or `/pakka:review`. Catches cases that explicit invocation misses.\n\n**4-vector compression:** output tokens · input context · tool results · subagent returns — all compressed independently.\n\n**Review gate:** reviewer + security + architect subagents run in parallel on every Claude-authored commit. Confidence threshold ≥ 80. Blocks on `severity=error` findings.\n\n**Deny-by-default permissions:** secrets, destructive git, shell-fetched-then-executed commands blocked at the permission layer.\n\n**Audit trail:** every tool call appended to `~/.pakka/audit/\u003csession\u003e.jsonl`. No dial-home.\n\n**recall:** `/pakka:recall` searches your audit trail. cross-session memory backed by local FTS5 index (SQLite). no remote storage.\n\n**skill-check:** `UserPromptSubmit` hook keyword-scans every message. if a build/plan/review signal matches, targeted alert fires before the model responds. no more relying on model memory.\n\n**Status line:** `pakka [super-ultra] · ↑12.4K (43%) / ↓7.0K (40%) tokens saved · 2 bugs caught` — compression level, token savings, and bugs caught, always visible.\n\n## Results (v0.1.0)\n\nThree absolute numbers, each verifiable from artifacts in this repo.\n\n1. **Bug catch rate: 9/10.** Combined reviewer + security + architect agents caught 9 of 10 seeded bugs on the Pass 5b in-session corpus. vs-raw A/B deferred to v0.2.0.\n\n2. **Bytes saved: 75,955 cumulative** since 2026-04-24. Estimated tokens: 21,763 (bytes ÷ 3.5). Source: `RECEIPTS.md`, regenerated via `make self-report`.\n\n3. **Gate enforcement: every Claude-authored commit path.** Architectural claim — gate runs and blocks on findings. Verify: `git log --format='%H' | while read sha; do git show -s --format='%(trailers:key=Reviewed-by-pakka,valueonly=true)' \"$sha\" | grep -q . \u0026\u0026 echo \"$sha\"; done | wc -l`.\n\n## Attribution\n\nEvery commit pakka reviews carries:\n\n```\nReviewed-by-pakka: v0.1.0 (gate: passed)\nCo-authored-by: pakka \u003c279024857+pakka-bot@users.noreply.github.com\u003e\n```\n\nOpt out: `pakka.signature: false` or `pakka.coAuthor: false` in `settings.json`.\n\n## Development\n\nBuilt using pakka. See [`DESIGN.md`](./DESIGN.md) and [`CLAUDE.md`](./CLAUDE.md).\n\n## License\n\nApache-2.0. See [`LICENSE`](./LICENSE) and [`NOTICE`](./NOTICE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famargautam%2Fpakka","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famargautam%2Fpakka","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famargautam%2Fpakka/lists"}