joogy06/agent-foundry/accounting-uk-ltd

Accounting — UK small VAT-registered Ltd

The operating skill for a small UK limited company that is VAT-registered: keep the books, reconcile them, file VAT, close the year, compute corporation tax, run payroll, and hit every deadline.

1. What this family cannot do — read first

These skills do not file anything, and must never imply they do.

The joint HMRC/Companies House online filing service closed on 31 March 2026. Since then:

So the job here is everything up to submission: ingest the documents, keep the books, reconcile, compute, validate, produce the figures and the audit trail, and name the deadline. Then hand to recognised software or an accountant.

Say this out loud to the user when they ask you to "file" something. A skill that lets someone believe a return was submitted is worse than one that refuses.

2. THE ROUTINE — run this every time this skill is invoked

Do this before answering anything. It takes seconds and it is what makes the skill an operating system for the company rather than a reference book.

T=.accounting/tracker.json          # per-company, in the project
 
# 1. FIRST CONTACT ONLY — no tracker yet? Analyse the business and build one.
python3 ~/.claude/skills/accounting-uk-ltd/scripts/tracker.py \
    init --company company.json --out "$T"
 
# 2. EVERY invocation — what is overdue, due soon, or newly in force
python3 ~/.claude/skills/accounting-uk-ltd/scripts/tracker.py status --tracker "$T"
 
# 2b. EVERY invocation — what CHANGED about the business itself
python3 ~/.claude/skills/business-profile/scripts/profile.py \
    --profile .accounting/business-profile.json check
 
# 3. Record progress as it happens (evidence is REQUIRED to mark done)
python3 ~/.claude/skills/accounting-uk-ltd/scripts/tracker.py \
    update --tracker "$T" --id vat_return-quarter-ending-2026-09-30 \
    --status done --evidence "HMRC receipt IRmark ABC123"
 
# 4. Periodically — what law/rates need re-verifying
python3 ~/.claude/skills/accounting-uk-ltd/scripts/tracker.py law-check --tracker "$T"

No tracker → run `init` first. Establish §3's facts by asking, build the calendar, and say what was assumed. Do not answer a VAT or year-end question for a company you have not profiled: the answer depends on the scheme, the ARD and the framework, and guessing those produces a confident wrong answer.

Tracker exists → run `status` first, and lead your reply with anything overdue. The user asking about one thing does not make the other obligations stop running.

Run the profile `check` too. The tracker knows what is DUE; the profile knows what the business normally LOOKS like — who each vendor is, how they bill, what they normally cost. It answers "who is this transaction?" without rediscovering it every session, and it flags a recurring bill that stopped arriving, which no balance check can see. See business-profile.

What the routine guarantees

• Due dates are computed from the profile plus the statutory rule, and each obligation carries

the rule it came from — so a date you disagree with can be argued with rather than just distrusted.

• `overdue` cannot be asserted away. It is derived from the due date and today, every run. You

may record that something is done; nobody can record that it is not due.

• `done` requires evidence. A submission reference, receipt or filing id. "Done" with nothing

behind it is indistinguishable from forgotten.

• `init` refuses to invent a profile. A missing accounting reference date is a question, not a

default.

The law-watch loop, and its honest limit

law-check computes staleness and prints the sources to verify. It cannot browse. You fetch them, then record what you found:

python3 .../tracker.py law-check --tracker "$T" \
    --record-checked "CT rates unchanged; employer thresholds unchanged; Apr-2028 accounts reform confirmed"

Recording a check without actually fetching is the failure this is built to make visible. It flags when the rates reference passes its REVIEW_BY, when the check interval lapses (default 90 days), and when a watched change comes within a year of taking effect — currently the April 2027 CT600 boxes and the April 2028 accounts reform.

When something HAS changed, update references/rates-2026-27.md and its REVIEW_BY, then say which figures moved and what they affect. A rates file that silently outlives its review date is this family's worst failure mode: it produces confidently wrong tax figures that nobody can see are wrong.

3. The engagement flow

ONBOARD ─► BOOKKEEP ─► RECONCILE ─► VAT QUARTER ─► YEAR-END ─► TAX ─► HANDOFF
   │           │            │            │             │         │        │
   │           │            │            │             │         │        └─ recognised software / agent
   │           │            │            │             │         └─ uk-corporation-tax (CT600, computations)
   │           │            │            │             └─ uk-statutory-accounts (FRS 105 / 102 1A, CH accounts)
   │           │            │            └─ uk-vat (9 boxes, scheme, MTD digital link)
   │           │            └─ bookkeeping-double-entry (bank rec, control + clearing accounts, TB)
   │           └─ financial-document-ingestion (PDF statements, PDF invoices, CSV exports)
   └─ this skill (§4 facts to establish, §5 deadline map)
 
  uk-payroll runs on its own monthly cycle throughout, feeding wages/PAYE/NI into the books.

4. ONBOARD — establish these before doing any work

Get these wrong and everything downstream is wrong. Record each as confirmed or assumed, and treat an assumed one exactly as business-edge treats an assumed margin: it cannot carry a conclusion on its own.

5. The deadline map — the highest-value thing in this file

Deadlines are the errors that cost real money, and the pairs below are the ones people conflate.

Payment and filing are different obligations with different dates and separate penalties. Say which one you mean, every time.

6. Rates and thresholds

Never quote a rate from memory, and never inline one into prose. All current figures live in one place with a review date and a primary-source URL per figure:

→ references/rates-2026-27.md

Two of three secondary summaries checked while building this family were materially wrong — one reported the CT main rate as 19% (that is the small profits rate), another gave the employer secondary threshold 10× too high. That is why the rule is absolute: cite the reference, state the tax year the figure belongs to, and refuse to apply a rate to a period it does not cover.

7. Routing

8. Standing rules