surplus
Skill16 starsChanged 44 days agoMITView on GitHub
Run the Tax Surplus / ACB engine (Reg. 5907, per-layer FX, 212-identity reconciliation harness) or its human-gated assurance loop. Use for cross-border tax demos, the FX sign-flip, --check gating, or drifted-workpaper remediation.
In this repository15 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- apSkill
- atlasSkill
- brainSkill
- brand-graphicsSkill
- build-loopSkill
- closeSkill
- linkedin-postSkill
- loopsSkill
- reconSkill
- shipSkill
- site-updateSkill
- tax-1065Skill
- triangulateSkill
- validateSkill
The file
Files
Tax Surplus / ACB Engine
Package surplus_engine in tax-surplus-engine/. Seed 20240607. Canadian foreign-affiliate surplus pools, distribution waterfall, ACB on capital events only.
Commands (run from tax-surplus-engine/)
python -m surplus_engine --start 2021 --end 2024 --out out --xlsx
python -m surplus_engine --start 2021 --end 2024 --check # 212 identity checks; exit 1 on any break
python -m surplus_engine.loop --demo --out out # HUMAN-GATED LOOP: settle drifted periods earliest-first
python -m pytest -q # 7,498 testsShowpieces
- FX sign-flip:
out/fx_layer_analysis.md— USD ACB $0 but per-layer CAD ACB $(660.35); find the flag glyph. - Loop demo: 3 turns lock FY2021-23, breaks 6->4->2->0, verdict FLAG (CAD 107,088.50 adjustments for human review).
Loop verdicts (surplus_engine/loop.py)
PASS (0) / FLAG (0, material -> human reviews what changed) / FAIL (1). Sensor = reconcile.py (independent re-derivation); authority = SurplusEngine.run on seeded facts. Never invents: settled set is byte-identical to a clean run.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

