diff options
| author | Danilo M. <danix@danix.xyz> | 2026-06-30 11:27:05 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-06-30 11:27:05 +0200 |
| commit | 5db160c123b70e37c98bb8a534e51d3ae9af8a71 (patch) | |
| tree | ed14ec1f0982baf187a3947cbd9076bc5d135046 | |
| parent | ba159a5d08971152f18fe2fb77e97afbdac02a57 (diff) | |
| download | firefly-cli-5db160c123b70e37c98bb8a534e51d3ae9af8a71.tar.gz firefly-cli-5db160c123b70e37c98bb8a534e51d3ae9af8a71.zip | |
docs: sync CLAUDE.md (errors.py, SKILL.md upkeep)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
| -rw-r--r-- | CLAUDE.md | 11 |
1 files changed, 9 insertions, 2 deletions
@@ -9,8 +9,9 @@ The Firefly III source is cloned at `../GITHUB/firefly-iii/` for reference only ## Architecture - `firefly_cli/` package. Shared primitives: `config.py` (env over TOML file), - `client.py` (HTTP + auth + error surfacing), `resolver.py` (name->id), - `output.py` (JSON default, `--human` tables), `registry.py` + `context.py`. + `client.py` (HTTP + auth + error surfacing), `errors.py` (FireflyError + hierarchy), `resolver.py` (name->id), `output.py` (JSON default, `--human` + tables), `registry.py` + `context.py`. - Commands live in `firefly_cli/commands/`, one module per group. Each command registers via the `@registry.command("group leaf", ...)` decorator. - `cli.py` builds argparse subparsers from the registry. `commands/__init__.py` @@ -23,6 +24,7 @@ The Firefly III source is cloned at `../GITHUB/firefly-iii/` for reference only `fn(args, ctx) -> int`. `ctx` has `.client`, `.resolver`, `.human`. 3. If it is a new module, add it to the import line in `commands/__init__.py`. 4. Write a unit test under `tests/unit/` (mock `ctx.client` / `ctx.resolver`). +5. Update `SKILL.md` (the agent-operating guide) with the new command. No other files change. ## Conventions @@ -39,5 +41,10 @@ No other files change. `FIREFLY_TEST_URL` / `FIREFLY_TEST_TOKEN`, skipped otherwise. Write tests create-then-delete their own records. NEVER point these at real data. +## Agent guide +`SKILL.md` documents how an agent drives the `firefly` command (the JSON/exit +contract, name resolution, task recipes). Keep it in sync when commands change. +It carries skill frontmatter and is symlinked into the Claude Code skills dir. + ## License GPLv2-only. Per-file header: `Copyright (C) 2026 Danilo M. <danix@danix.xyz>`. |