Jakob WennbergandClaude Fable 5
e33cc2428d
Ships an installable Claude Code plugin (/plugin marketplace add erp-mafia/accounted) that bundles the MCP connection (OAuth, zero-key) with seven short workflow skills following the Swedish bookkeeping rhythm: start, bookkeep, check, month-close, vat, payroll, year-end. Wrappers are deliberately thin: they ground in the agent briefing and Accounted:// resources, load server-side workflow skills and regulatory atoms via gnubok_load_skill at need, and stage every write for user approval. No knowledge is duplicated into the plugin. A vitest cross-checks every skill slug, atom id, resource URI, and tool name the wrappers reference against the MCP server source, so a server rename fails CI instead of a user's chat session. Assessment and follow-ups in dev_docs/claude_plugin.md (local, dev_docs is unpublished by design). Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
30 lines
2.1 KiB
Markdown
30 lines
2.1 KiB
Markdown
---
|
|
name: start
|
|
description: Connect and orient in the user's Accounted bookkeeping. Use on first contact with Accounted in a session, when the user says "kom igang", "get started", "connect my bookkeeping", "vad behover jag gora", or asks what this plugin can do.
|
|
---
|
|
|
|
# Start
|
|
|
|
Verify the connection, learn who this company is, and surface what needs attention. Run this before any other Accounted flow in a session.
|
|
|
|
## Flow
|
|
|
|
1. Call `gnubok_get_agent_briefing`. This is the single source for company facts: entity type (aktiebolag or enskild firma), accounting method (faktureringsmetoden or kontantmetoden), VAT period, employees, and ledger context. Never assume these; the flows below behave differently depending on them.
|
|
- If the call fails with an auth error, the MCP server is not connected yet: tell the user to run `/mcp` and authenticate with Accounted (OAuth consent screen; read-only scopes by default, write scopes are ticked explicitly). Self-hosted users: see the plugin README.
|
|
2. Read `Accounted://attention` and `Accounted://period/active`.
|
|
3. Present a short orientation in the user's language: company name and form, active fiscal period and its lock status, and the top 3 items needing attention.
|
|
4. Point at the flows, matched to what attention showed:
|
|
- `/accounted:bookkeep` - clear unbooked transactions and receipts (daily)
|
|
- `/accounted:check` - read-only health check of the books
|
|
- `/accounted:month-close` - close the month
|
|
- `/accounted:vat` - prepare the momsdeklaration
|
|
- `/accounted:payroll` - monthly salary run and AGI
|
|
- `/accounted:year-end` - bokslut
|
|
5. Mention that deeper, company-tailored guides exist on the server: `gnubok_list_skills` lists them (workflow guides plus Swedish regulatory skills, filtered to this company), and `gnubok_load_skill(slug)` loads any of them.
|
|
|
|
## Rules
|
|
|
|
- Ground every statement in the briefing and resources; never guess company facts.
|
|
- Swedish accounting or tax questions are answered from loaded skills, never from memory.
|
|
- Every write in Accounted stages a pending operation for the user to approve. Nothing is ever booked without explicit approval.
|