Two changes bundled — together they shift the operator's primary entry point from "ask Claude" to "run a CLI", while the skills remain the source of behaviour documentation + Claude triggers.
bin/arcodange — read-only operator CLI
Bash dispatcher at the project root. One entry point, subcommands per domain:
Locates the project root via git rev-parse so it works from any CWD.
Per-subcommand help text. Unknown commands exit 2 with a hint.
Reuses the existing per-skill scripts via exec — zero behaviour drift, full credit to the existing tested code.
Read-only by design (delegates to dol-curl.sh and the per-skill scripts, all of which use the read-only ai_agent key).
dolibarr-tva-summary — the V5 skill (composite TVA report)
Composes dolibarr-tva-reconciliation (TVA collectée — customer side) and dolibarr-tva-deductible (TVA déductible — supplier side) into one CA3-ready monthly summary:
Per month: each bucket (A1 / A4 / E2 / ligne 19/20 / ligne 17+24 / FR exempt) with HT and TVA.
Per month: net = collectée − déductible with verdict (TVA à reverser, crédit de TVA, ou équilibre).
Cumul: cumulative collectée + déductible + net across the window.
Live baseline (all-time): Arcodange is in cumulative TVA credit of 223.22 € — 0 € collectée (KissMetrics autoliquidation 259-1° CGI) against 223.22 € déductible (mostly FR suppliers at 20 %). Each month consistently shows credit; suggests requesting reimbursement or carrying forward.
Documentation updates
Project root README.md: gains a CLI — bin/arcodange section as the primary operator entry point (above the existing Dolibarr operational notes).
Every existing SKILL.md gets a one-line "CLI shortcut" near the top so the human path is discoverable from any skill page. The skills remain the canonical behaviour reference + Claude-trigger source.
CLI works from any CWD inside the worktree (uses git rev-parse for root)
V6 candidates
arcodange-bank-reco — match Dolibarr payments against Qonto/Wise CSV exports (the last loop-closer for the cohort review accounting trail).
arcodange-k8s — kubectl read-only operations against the erp namespace (pod state, logs, cert expiry).
arcodange-backups — audit the backup/ scripts' last-run state + integrity check.
arcodange tva ca3-csv — emit a CSV directly transcribable into impots.gouv.fr (probably a CLI flag on tva summary).
## Summary
Two changes bundled — together they shift the operator's primary entry point from "ask Claude" to "run a CLI", while the skills remain the source of behaviour documentation + Claude triggers.
### `bin/arcodange` — read-only operator CLI
Bash dispatcher at the project root. One entry point, subcommands per domain:
```sh
bin/arcodange ping
bin/arcodange whoami
bin/arcodange invoice list
bin/arcodange invoice audit 12
bin/arcodange payments state
bin/arcodange payments timeline --year 2026
bin/arcodange tva summary
bin/arcodange tva collect --year 2026
bin/arcodange tva deductible
bin/arcodange thirdparty audit 1
bin/arcodange thirdparty audit-all
bin/arcodange templates inspect 1
bin/arcodange snapshot --out /tmp/erp.json
bin/arcodange curl /invoices/12
bin/arcodange help
```
- Locates the project root via `git rev-parse` so it works from any CWD.
- Per-subcommand `help` text. Unknown commands exit 2 with a hint.
- Reuses the existing per-skill scripts via `exec` — zero behaviour drift, full credit to the existing tested code.
- Read-only by design (delegates to `dol-curl.sh` and the per-skill scripts, all of which use the read-only `ai_agent` key).
### `dolibarr-tva-summary` — the V5 skill (composite TVA report)
Composes `dolibarr-tva-reconciliation` (TVA collectée — customer side) and `dolibarr-tva-deductible` (TVA déductible — supplier side) into one CA3-ready monthly summary:
- Per month: each bucket (A1 / A4 / E2 / ligne 19/20 / ligne 17+24 / FR exempt) with HT and TVA.
- Per month: net = collectée − déductible with verdict (TVA à reverser, crédit de TVA, ou équilibre).
- Cumul: cumulative collectée + déductible + net across the window.
**Live baseline** (all-time): Arcodange is in **cumulative TVA credit of 223.22 €** — 0 € collectée (KissMetrics autoliquidation 259-1° CGI) against 223.22 € déductible (mostly FR suppliers at 20 %). Each month consistently shows credit; suggests requesting reimbursement or carrying forward.
### Documentation updates
- **Project root `README.md`**: gains a `CLI — bin/arcodange` section as the primary operator entry point (above the existing Dolibarr operational notes).
- Every existing **`SKILL.md`** gets a one-line "CLI shortcut" near the top so the human path is discoverable from any skill page. The skills remain the canonical behaviour reference + Claude-trigger source.
## Test plan
- [ ] `bin/arcodange help` → full command tree
- [ ] `bin/arcodange ping` → Dolibarr 22.0.4
- [ ] `bin/arcodange whoami` → ai_agent
- [ ] `bin/arcodange invoice list` → 5-row KM table
- [ ] `bin/arcodange tva summary` → cumulative credit 223.22 €
- [ ] `bin/arcodange thirdparty audit-all` → 10 audited, 5 with gaps
- [ ] `bin/arcodange snapshot --print-only | jq .content_hash` → sha256 prefix
- [ ] `bin/arcodange tva nope` → exit 2 with hint
- [ ] CLI works from any CWD inside the worktree (uses git rev-parse for root)
## V6 candidates
- `arcodange-bank-reco` — match Dolibarr payments against Qonto/Wise CSV exports (the last loop-closer for the cohort review accounting trail).
- `arcodange-k8s` — kubectl read-only operations against the erp namespace (pod state, logs, cert expiry).
- `arcodange-backups` — audit the `backup/` scripts' last-run state + integrity check.
- `arcodange tva ca3-csv` — emit a CSV directly transcribable into impots.gouv.fr (probably a CLI flag on `tva summary`).
Two changes that go together: now operators can run every read-only
workflow without going through Claude. The skills (SKILL.md files)
remain the source of behaviour documentation and Claude triggers;
bin/arcodange is the human-facing entry point.
bin/arcodange:
- Bash dispatcher at the project root. Subcommands per domain:
tva {collect, collect-detail, deductible, deductible-detail, summary},
invoice {list, audit}, thirdparty {audit, audit-all},
payments {state, timeline, by-month},
templates {list, inspect},
snapshot, whoami, ping, curl, help.
- Locates the project root via `git rev-parse` so it works from any
CWD (including from a worktree).
- Per-subcommand `help` text. Unknown commands exit 2 with a hint.
- Reuses the existing per-skill scripts under .claude/skills/<name>/
scripts/ via `exec` (zero behaviour drift, full credit to the
existing tested code).
dolibarr-tva-summary:
- Composes dolibarr-tva-reconciliation (TVA collectée customer-side)
and dolibarr-tva-deductible (TVA déductible supplier-side) into a
single CA3-ready monthly summary with per-month net verdict
(TVA à reverser / crédit de TVA / équilibre) and a cumulative line.
- Live baseline: Arcodange en crédit de TVA de 223.22 € cumulé
(0 € collectée 259-1° CGI vs 223.22 € déductible).
- Exposed as `arcodange tva summary [--year|--since|--until]`.
Each existing skill's SKILL.md gets a one-line "CLI shortcut" near
the top so the human path is discoverable from any skill page.
The project root README.md gets a CLI section as the primary
operator entry point.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Summary
Two changes bundled — together they shift the operator's primary entry point from "ask Claude" to "run a CLI", while the skills remain the source of behaviour documentation + Claude triggers.
bin/arcodange— read-only operator CLIBash dispatcher at the project root. One entry point, subcommands per domain:
git rev-parseso it works from any CWD.helptext. Unknown commands exit 2 with a hint.exec— zero behaviour drift, full credit to the existing tested code.dol-curl.shand the per-skill scripts, all of which use the read-onlyai_agentkey).dolibarr-tva-summary— the V5 skill (composite TVA report)Composes
dolibarr-tva-reconciliation(TVA collectée — customer side) anddolibarr-tva-deductible(TVA déductible — supplier side) into one CA3-ready monthly summary:Live baseline (all-time): Arcodange is in cumulative TVA credit of 223.22 € — 0 € collectée (KissMetrics autoliquidation 259-1° CGI) against 223.22 € déductible (mostly FR suppliers at 20 %). Each month consistently shows credit; suggests requesting reimbursement or carrying forward.
Documentation updates
README.md: gains aCLI — bin/arcodangesection as the primary operator entry point (above the existing Dolibarr operational notes).SKILL.mdgets a one-line "CLI shortcut" near the top so the human path is discoverable from any skill page. The skills remain the canonical behaviour reference + Claude-trigger source.Test plan
bin/arcodange help→ full command treebin/arcodange ping→ Dolibarr 22.0.4bin/arcodange whoami→ ai_agentbin/arcodange invoice list→ 5-row KM tablebin/arcodange tva summary→ cumulative credit 223.22 €bin/arcodange thirdparty audit-all→ 10 audited, 5 with gapsbin/arcodange snapshot --print-only | jq .content_hash→ sha256 prefixbin/arcodange tva nope→ exit 2 with hintV6 candidates
arcodange-bank-reco— match Dolibarr payments against Qonto/Wise CSV exports (the last loop-closer for the cohort review accounting trail).arcodange-k8s— kubectl read-only operations against the erp namespace (pod state, logs, cert expiry).arcodange-backups— audit thebackup/scripts' last-run state + integrity check.arcodange tva ca3-csv— emit a CSV directly transcribable into impots.gouv.fr (probably a CLI flag ontva summary).Two changes that go together: now operators can run every read-only workflow without going through Claude. The skills (SKILL.md files) remain the source of behaviour documentation and Claude triggers; bin/arcodange is the human-facing entry point. bin/arcodange: - Bash dispatcher at the project root. Subcommands per domain: tva {collect, collect-detail, deductible, deductible-detail, summary}, invoice {list, audit}, thirdparty {audit, audit-all}, payments {state, timeline, by-month}, templates {list, inspect}, snapshot, whoami, ping, curl, help. - Locates the project root via `git rev-parse` so it works from any CWD (including from a worktree). - Per-subcommand `help` text. Unknown commands exit 2 with a hint. - Reuses the existing per-skill scripts under .claude/skills/<name>/ scripts/ via `exec` (zero behaviour drift, full credit to the existing tested code). dolibarr-tva-summary: - Composes dolibarr-tva-reconciliation (TVA collectée customer-side) and dolibarr-tva-deductible (TVA déductible supplier-side) into a single CA3-ready monthly summary with per-month net verdict (TVA à reverser / crédit de TVA / équilibre) and a cumulative line. - Live baseline: Arcodange en crédit de TVA de 223.22 € cumulé (0 € collectée 259-1° CGI vs 223.22 € déductible). - Exposed as `arcodange tva summary [--year|--since|--until]`. Each existing skill's SKILL.md gets a one-line "CLI shortcut" near the top so the human path is discoverable from any skill page. The project root README.md gets a CLI section as the primary operator entry point. Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>