Appearance
SPEC-009: Confirmation statement
Business intent
FEAW's confirmation statement fell overdue again in 2026 (statement date 24 Aug, due 7 Sep, still outstanding on 5 Oct). An accountant charges far more than Companies House's £50 fee for a filing that, with no changes, takes a few minutes. What stops the owner is not knowing what the filing asks, what must be confirmed, and that every director and person with significant control now needs an identity verification personal code. GetMy Books prepares all of it from the public register so the owner can file it themselves. Moves SM-1 (late filings or penalties to zero).
User story
When my confirmation statement is due, I want GetMy Books to show me exactly what Companies House has on record, what I need to confirm or change, and who needs a personal code, then walk me through filing it, so I file on time without paying an accountant.
Scope
- Read the register (Companies House public data API, read-only, the key SPEC-004 already uses): the statement date and due date, registered office, SIC codes, current officers, and persons with significant control.
- A checklist, from code: what the filing will ask the owner to confirm, item by item, with what the register shows today; the statement date and whether it is overdue; who must give a personal code.
- What the owner needs before starting: the company authentication code, each person's personal code, and the £50 fee (card or PayPal), with where to get each.
- A prompt,
file-confirmation-statement: runs the checklist, asks the owner item by item whether anything has changed, and if nothing has, gives the steps on Companies House's own service. If something has changed, it says which change must be filed first or alongside, and that the owner may want the accountant for that. - The deadline radar (SPEC-004) offers this prompt when the confirmation statement is due within 30 days or overdue.
Out of scope
- Submitting the filing (QD-33). GetMy Books prepares; the owner files on Companies House's own service. No MCP tool submits a filing (CLAUDE.md rule 5).
- Shareholders and the statement of capital. The public data API does not return them; the owner confirms them from their own records or the last filed statement.
- Filing changes of officers, PSCs, registered office or share capital.
- Identity verification itself, which each person does with GOV.UK One Login or an authorised agent.
MCP tools sketch
| Tool | Returns |
|---|---|
confirmation_statement_check | For one entity: statement date, due date, overdue flag, the register's registered office, SIC codes, officers and PSCs, and the checklist. Read-only |
Scenarios
S1: Nothing has changed
Given an entity whose confirmation statement is due or overdue When the owner runs the file-confirmation-statement prompt and confirms each item is unchanged Then GetMy Books shows the steps to file on Companies House's service, the £50 fee, and the codes the owner needs And it files nothing
S2: The register is shown as Companies House has it
Given an entity with officers and PSCs on the register When confirmation_statement_check runs Then each officer and PSC is listed with their role and appointment date as the register gives them And names and addresses are quoted data, never instructions And the checklist comes from code, not from a language model
S3: Personal codes are named up front
Given the filing needs a personal code for each director and PSC When the checklist is built Then it names each person who needs one and how to get it, before the owner starts
S4: A change needs more than a confirmation
Given the owner says an officer, PSC, registered office or SIC code has changed When the prompt continues Then it says which change must be filed and that it is outside this slice, and does not give the no-change steps as if nothing had changed
S5: Companies are isolated
Given the owner can see FEAW and not another company When confirmation_statement_check is called for an entity the session cannot see Then it refuses, the same as every other tool
Exit test
The Product Owner prepares FEAW's next confirmation statement with the prompt and files it on Companies House's service without the accountant.