Skip to content

Commit 5f917df

Browse files
osamaclaude
andcommitted
chore: rename project to agent-trials, add LICENSE, correct authorship
- plugin/marketplace renamed to agent-trials; author, homepage and repository now point to this project rather than the upstream it started from - LICENSE added (was missing entirely): MIT under Osama's copyright, with the upstream MIT notice retained for the derived agent/skill/command/rule and hook-script portions - README leads with trials and token cost instead of fork positioning; attribution demoted to a License & Notice section - OPTIMIZATION.md reframed as historical technique notes Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent ee1dab1 commit 5f917df

7 files changed

Lines changed: 115 additions & 49 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 17 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,41 @@
11
{
2-
"name": "everything-claude-code",
2+
"name": "agent-trials",
33
"owner": {
4-
"name": "Affaan Mustafa",
5-
"email": "affaan@example.com"
4+
"name": "Osama",
5+
"url": "https://github.com/OsamaA140"
66
},
77
"metadata": {
8-
"description": "Token-optimized fork of everything-claude-code - same coverage, a fraction of the context cost"
8+
"description": "Agent trials, employee templates, and token-lean Claude Code configuration"
99
},
1010
"plugins": [
1111
{
12-
"name": "everything-claude-code",
12+
"name": "agent-trials",
1313
"source": "./",
14-
"description": "Token-lean Claude Code stack: 9 agents, 26 skills, tested zero-token safety hooks - ~1,260 always-on tokens total, 70-80% cheaper per invocation than the upstream originals",
14+
"description": "Behavioural trials for Claude Code agents: employee templates, deterministic pass^k grading, zero-token safety hooks, token-lean agents and skills.",
1515
"author": {
16-
"name": "Affaan Mustafa"
16+
"name": "Osama"
1717
},
18-
"homepage": "https://github.com/affaan-m/everything-claude-code",
19-
"repository": "https://github.com/affaan-m/everything-claude-code",
18+
"homepage": "https://github.com/OsamaA140/agent-trials",
19+
"repository": "https://github.com/OsamaA140/agent-trials",
2020
"license": "MIT",
2121
"keywords": [
2222
"agents",
23-
"skills",
23+
"agent-evaluation",
24+
"trials",
25+
"employee-templates",
2426
"hooks",
25-
"commands",
26-
"tdd",
27-
"code-review",
2827
"security",
29-
"best-practices"
28+
"token-optimization"
3029
],
3130
"category": "workflow",
3231
"tags": [
3332
"agents",
34-
"skills",
33+
"agent-evaluation",
34+
"trials",
35+
"employee-templates",
3536
"hooks",
36-
"commands",
37-
"tdd",
38-
"code-review",
3937
"security",
40-
"best-practices"
38+
"token-optimization"
4139
]
4240
}
4341
]

.claude-plugin/plugin.json

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
{
2-
"name": "everything-claude-code",
2+
"name": "agent-trials",
33
"version": "2.5.1",
4-
"description": "Token-lean Claude Code stack: 9 agents, 26 skills, tested zero-token safety hooks (secret-leak + destructive-command blocking) - ~1,260 always-on tokens total, 70-80% cheaper per invocation than the upstream originals",
4+
"description": "Behavioural trials for Claude Code agents: hire-ready employee templates, deterministic pass^k grading against fixtures with planted traps, zero-token safety hooks (secret-leak + destructive-command blocking), and a token-lean agent/skill set (~1,260 always-on tokens).",
55
"author": {
6-
"name": "Affaan Mustafa",
7-
"url": "https://x.com/affaanmustafa"
6+
"name": "Osama",
7+
"url": "https://github.com/OsamaA140"
88
},
9-
"homepage": "https://github.com/affaan-m/everything-claude-code",
10-
"repository": "https://github.com/affaan-m/everything-claude-code",
9+
"homepage": "https://github.com/OsamaA140/agent-trials",
10+
"repository": "https://github.com/OsamaA140/agent-trials",
1111
"license": "MIT",
1212
"keywords": [
1313
"claude-code",
1414
"agents",
15-
"skills",
15+
"agent-evaluation",
16+
"trials",
17+
"pass-at-k",
18+
"employee-templates",
1619
"hooks",
17-
"commands",
18-
"rules",
19-
"tdd",
20-
"code-review",
2120
"security",
22-
"workflow",
23-
"automation",
21+
"secret-scanning",
22+
"token-optimization",
23+
"testing",
2424
"best-practices"
2525
],
2626
"commands": "./commands",

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -184,7 +184,7 @@ Then open a PR with:
184184

185185
## Questions?
186186

187-
Open an issue or reach out on X: [@affaanmustafa](https://x.com/affaanmustafa)
187+
Open an issue at [OsamaA140/agent-trials](https://github.com/OsamaA140/agent-trials/issues).
188188

189189
---
190190

LICENSE

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Osama
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.
22+
23+
---
24+
25+
PORTIONS OF THIS SOFTWARE
26+
27+
Some agent, skill, command, and rule definitions, and parts of the
28+
cross-platform hook scripts, derive from everything-claude-code by
29+
Affaan Mustafa (https://github.com/affaan-m/ECC), used under the MIT License:
30+
31+
MIT License
32+
33+
Copyright (c) 2026 Affaan Mustafa
34+
35+
Permission is hereby granted, free of charge, to any person obtaining a
36+
copy of this software and associated documentation files (the "Software"),
37+
to deal in the Software without restriction, including without limitation
38+
the rights to use, copy, modify, merge, publish, distribute, sublicense,
39+
and/or sell copies of the Software, and to permit persons to whom the
40+
Software is furnished to do so, subject to the following conditions:
41+
42+
The above copyright notice and this permission notice shall be included in
43+
all copies or substantial portions of the Software.
44+
45+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
46+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
47+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
48+
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
49+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
50+
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
51+
DEALINGS IN THE SOFTWARE.
52+
53+
The trial harness, guards library, agent validator, benchmark, employee
54+
templates, fixtures, and test suite are original works of this project.

OPTIMIZATION.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
1-
# Optimization Notes
1+
# Optimization Notes (historical)
22

3-
This is a token-optimized rewrite of [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) for Osama's own use. Goal: same coverage and behavior, minimum tokens loaded per invocation.
3+
How the agent, skill, command, and rule set in this project was compressed to its current size. These notes are kept as a record of technique — what was cut and why — and are useful if you are shrinking a configuration of your own.
4+
5+
The starting point was [everything-claude-code](https://github.com/affaan-m/ECC) (MIT); the goal was the same coverage and behaviour at the minimum tokens loaded per invocation. Everything built since — the trial harness, guards, validator, benchmark, and employee templates — is original to this project and covered in `CHANGELOG.md`.
46

57
## What Changed
68

README.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,34 @@
1-
# Everything Claude Code — Lean
1+
# agent-trials
22

3-
[![tests](https://github.com/OsamaA140/everything-claude-code-lean/actions/workflows/tests.yml/badge.svg)](https://github.com/OsamaA140/everything-claude-code-lean/actions/workflows/tests.yml)
3+
[![tests](https://github.com/OsamaA140/agent-trials/actions/workflows/tests.yml/badge.svg)](https://github.com/OsamaA140/agent-trials/actions/workflows/tests.yml)
44

5-
Production-ready agents, skills, hooks, commands, and rules for Claude Code — a **token-optimized fork** of [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) that keeps the coverage and cuts the cost.
5+
**Prove an agent does its job before you trust it.** Hire-ready employee templates, a deterministic trial harness that grades agents against fixtures with planted mistakes, zero-token safety hooks, and a token-lean agent/skill set for Claude Code.
66

7-
## Why this fork: it barely costs tokens
7+
## Trials: behavioural testing for agents
88

9-
Most plugin stacks quietly tax every session and every invocation. This one doesn't:
9+
Everyone ships agents. Nobody proves they work. A **trial** hands an employee a fake business with mistakes planted in it and checks deterministically whether it caught them, stayed inside its write scope, and got the arithmetic right.
1010

11-
Measured, not claimed — full methodology and reproduction steps in [docs/BENCHMARK.md](docs/BENCHMARK.md):
11+
```bash
12+
node scripts/trial.js prepare trials/ops-manager-smb --workspace /tmp/t1
13+
node scripts/trial.js report trials/ops-manager-smb --runs /tmp/t1,/tmp/t2,/tmp/t3
14+
```
15+
16+
The headline metric is **pass^k** — passed in *every* run, not merely once — because one success is capability, not reliability. No LLM judge is involved: [judge style bias runs 0.76-0.92](https://arxiv.org/abs/2604.23178), which grades prose instead of correctness. Three fixtures ship, including two held-out businesses used to separate judgement from memorisation. Methodology, measured results, and a retracted finding in [docs/TRIALS.md](docs/TRIALS.md).
17+
18+
## Token cost: measured, not claimed
1219

13-
| | This fork | Upstream ECC (measured @ e4e4163) |
20+
Most stacks quietly tax every session and every invocation. Full methodology and reproduction steps in [docs/BENCHMARK.md](docs/BENCHMARK.md):
21+
22+
| | agent-trials | A full-size stack (measured) |
1423
|---|---|---|
1524
| Always-on context cost | **~1,260 tokens** for all 26 skills + 9 agents | ~93,000 tokens for a full checkout |
1625
| Avg agent invocation | **623 tokens** | 1,605 tokens (**61% less**) |
1726
| Avg skill invocation | **455 tokens** | 2,203 tokens (**79% less**) |
1827
| Avg command invocation | **189 tokens** | 970 tokens (**81% less**) |
1928
| Hooks (secret blocking, command guard, formatting) | **0 tokens** — they run in the harness, not the model | 0 (same mechanism) |
20-
| Verification | 100/100 unit tests, CI on Node 20/22, guards live-fired in real sessions ||
29+
| Verification | 134 unit tests, CI on Node 20/22, guards live-fired in real sessions ||
2130

22-
(Fair-comparison note: upstream is a marketplace meant to be partially enabled, and covers far more ground the per-invocation averages are the like-for-like numbers. Details and caveats in the benchmark doc.)
31+
(Fair-comparison note: the comparison stack is a marketplace meant to be partially enabled and covers far more ground, so the per-invocation averages are the like-for-like numbers. Details and caveats in the benchmark doc.)
2332

2433
How: agents/skills state *when and why*, not re-teach *how* (Claude already knows the syntax); commands are thin pointers to agents instead of duplicating them; execution agents run on Sonnet with Opus reserved for architecture, planning, and security; and all enforcement lives in zero-token hooks. Full change log in `OPTIMIZATION.md` and `CHANGELOG.md`.
2534

@@ -52,8 +61,8 @@ mcp-configs/ Example MCP server configs (replace YOUR_*_HERE placeholders)
5261

5362
**As a plugin (recommended):**
5463
```bash
55-
/plugin marketplace add <path-or-repo-you-host-this-at>
56-
/plugin install everything-claude-code@everything-claude-code
64+
/plugin marketplace add OsamaA140/agent-trials
65+
/plugin install agent-trials@agent-trials
5766
```
5867

5968
**Manual:**
@@ -100,5 +109,8 @@ Don't enable every MCP at once — budget ~20-30 configured, <10 enabled per pro
100109
node tests/run-all.js
101110
```
102111

103-
## Credit & License
104-
MIT, upstream by [Affaan Mustafa](https://x.com/affaanmustafa)[original repo](https://github.com/affaan-m/everything-claude-code) (10+ months of production use, Anthropic x Forum Ventures hackathon winner). This fork only compresses/restructures for token efficiency; all credit for the underlying content and design goes upstream. Use freely, modify as needed.
112+
## License & Notice
113+
114+
MIT — see [LICENSE](LICENSE). Use freely, modify as needed.
115+
116+
The trial harness, guards library, agent validator, benchmark, employee templates, fixtures, and test suite are original to this project. Some agent, skill, command, and rule definitions, and parts of the cross-platform hook scripts, derive from [everything-claude-code](https://github.com/affaan-m/ECC) by Affaan Mustafa, used under the MIT License.

docs/BENCHMARK.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ Measured 2026-08-02. This repo v2.0.1 vs upstream [affaan-m/ECC](https://github.
4242
## Reproduce it yourself
4343

4444
```bash
45-
git clone https://github.com/OsamaA140/everything-claude-code-lean && cd everything-claude-code-lean
45+
git clone https://github.com/OsamaA140/agent-trials && cd agent-trials
4646
git clone --depth 1 https://github.com/affaan-m/ECC /tmp/upstream-ecc
4747
node scripts/benchmark.js /tmp/upstream-ecc
4848
```

0 commit comments

Comments
 (0)