ca-return-assembly.md455 lines26.7 KB
v1Orchestrator
| 1 | --- |
| 2 | name: ca-return-assembly |
| 3 | description: Final orchestrator skill that assembles the complete Canadian filing package for Canadian-resident sole proprietors. Consumes outputs from all Canadian content skills (canada-gst-hst for GST34, ca-fed-t2125 for business income, ca-fed-t1-return for federal return, ca-fed-cpp-ei for CPP/CPP2/EI, ca-fed-instalments for instalment schedule) to produce a single unified reviewer package containing every worksheet, every form, every brief section, all cross-skill reconciliations, and the final action list with payment instructions, filing instructions, and next-year planning. This is the capstone skill that runs last and produces the final deliverable. MUST be loaded alongside all Canadian content skills listed above. Canadian full-year residents only. Sole proprietors only (not incorporated). |
| 4 | version: 0.1 |
| 5 | --- |
| 6 | |
| 7 | # Canada Return Assembly Skill v0.1 |
| 8 | |
| 9 | ## CRITICAL EXECUTION DIRECTIVE -- READ FIRST |
| 10 | |
| 11 | **When this skill is invoked, you have already passed through intake. The user has consented to the full workflow. Execute all steps without pausing for permission.** |
| 12 | |
| 13 | Specifically: |
| 14 | |
| 15 | - **Do NOT ask the user "how deep do you want me to go"** or "do you want the full package" or any variant. The user asked for their tax returns. They want their tax returns. Produce them. |
| 16 | - **Do NOT announce how many tokens or tool calls this will take.** Execute. |
| 17 | - **Do NOT ask which deliverables to prioritise.** Produce all deliverables listed in Section 4. If you run out of context mid-execution, finish the computation work first (numbers, positions, flags) then produce whatever formatted outputs you can, and at the very end state clearly which deliverables were not produced and why. |
| 18 | - **Do NOT re-validate scope that intake already validated.** If `ca-freelance-intake` produced an intake package, trust it. You can cross-check specific numbers during reconciliation but do not re-interrogate the user about residency, business structure, or anything else intake already captured. |
| 19 | - **Do NOT pause between content skills to check in.** Run them in dependency order (Section 2) without prose status updates between each one. A single status message at the end is fine. |
| 20 | - **Self-checks are targets, not blockers.** If a self-check fails, note it in the reviewer brief's open flags section and continue. Do NOT halt the entire workflow because one self-check had an ambiguous answer. |
| 21 | - **Primary source citations go in the final reviewer brief, not in intermediate computation steps.** |
| 22 | |
| 23 | **The user has already been told (by the intake skill) that the final package requires CPA/professional signoff before filing. State it once in the final output and move on.** |
| 24 | |
| 25 | **Failure mode to avoid:** The skill halts mid-execution and asks the user a meta-question about workflow pacing. If you feel the urge to ask "how should I proceed," the correct action is to pick the most defensible path and proceed, flagging the decision in the reviewer brief so the reviewer can challenge it. |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## What this file is |
| 30 | |
| 31 | The final capstone skill for Canadian sole proprietor returns. Every Canadian content skill feeds into this one. The output is the complete reviewer package that a CPA or licensed tax professional can review, sign off on, and deliver to the client along with filing instructions. |
| 32 | |
| 33 | This skill coordinates execution of the content skills, verifies cross-skill consistency, and assembles the final deliverable. |
| 34 | |
| 35 | --- |
| 36 | |
| 37 | ## Section 1 -- Scope |
| 38 | |
| 39 | Produces the complete Canadian filing package for: |
| 40 | - Full-year Canadian residents |
| 41 | - Sole proprietors (unincorporated) |
| 42 | - Tax year 2025 (calendar year, fiscal year end December 31) |
| 43 | - Filing GST34 (if registered), T2125, T1 federal return, CPP/CPP2/EI calculation, instalment schedule, provincial tax |
| 44 | |
| 45 | --- |
| 46 | |
| 47 | ## Section 2 -- Execution order and dependency chain |
| 48 | |
| 49 | The skill enforces the following execution order: |
| 50 | |
| 51 | 1. **`canada-gst-hst`** -- GST/HST return (GST34) |
| 52 | - Runs first because GST/HST revenue figures feed into the T2125 |
| 53 | - For registered filers: prepare annual or outstanding quarterly/monthly GST34 |
| 54 | - Output: line 101 revenue, line 105 GST/HST collected, line 108 ITCs, line 109 net tax |
| 55 | - **Status check:** canada-gst-hst is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute GST34 figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available. |
| 56 | |
| 57 | 2. **`ca-fed-t2125`** -- Statement of Business or Professional Activities |
| 58 | - Depends on GST34 output: gross business income must be reported net of GST/HST for registered filers |
| 59 | - Computes business expenses, CCA/immediate expensing, home office (Part 7), motor vehicle (Part 8) |
| 60 | - Output: T2125 line values -- gross revenue (line 8299), total expenses (line 9368), net income/loss (line 9946) |
| 61 | - **Status check:** ca-fed-t2125 is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute T2125 figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available. |
| 62 | |
| 63 | 3. **`ca-fed-t1-return`** -- Federal T1 individual return |
| 64 | - Depends on T2125: net business income flows to T1 line 13500 (gross self-employment income) and line 13700 (net self-employment income) |
| 65 | - Incorporates employment income (T4), other income, RRSP deduction, total income, taxable income, federal tax |
| 66 | - Output: T1 line values through line 43500 (total payable) and line 48500 (balance owing/refund) |
| 67 | - **Status check:** ca-fed-t1-return is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute T1 figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available. |
| 68 | |
| 69 | 4. **`ca-fed-cpp-ei`** -- CPP, CPP2, and EI self-employed |
| 70 | - Depends on T2125: CPP pensionable earnings = T2125 net income (line 9946) minus CPP basic exemption ($3,500) |
| 71 | - Self-employed pay both employee and employer portions of CPP (2 x 5.95% = 11.90% for 2025, on pensionable earnings up to YMPE minus basic exemption) |
| 72 | - CPP2: second ceiling earnings between YMPE and YAMPE (2 x 4% for 2025) |
| 73 | - EI: optional for self-employed (special benefits only); if opted in, pay employee rate only |
| 74 | - Half of CPP (employee portion) is deducted from net income on T1 line 22200; the other half (employer portion) is a non-refundable credit on Schedule 8 |
| 75 | - Output: total CPP owing, CPP2 owing, EI (if opted in), deduction amount, credit amount |
| 76 | - **Status check:** ca-fed-cpp-ei is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute CPP/EI figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available. |
| 77 | |
| 78 | 5. **`ca-fed-instalments`** -- Instalment schedule for 2026 |
| 79 | - Depends on T1: instalment base = net tax owing minus amounts withheld at source |
| 80 | - If net tax owing exceeds $3,000 ($1,800 for Quebec), CRA will require instalments for the following year |
| 81 | - Two methods: no-calculation option (use CRA's instalment reminders from NOA) or prior-year / current-year calculation |
| 82 | - Output: quarterly instalment amounts and due dates for 2026 (March 15, June 15, September 15, December 15) |
| 83 | - **Status check:** ca-fed-instalments is currently a Q4 stub. If the stub has substantive computation content, use it. If it is still a placeholder, compute instalment figures using the prior-year method and flag in the reviewer brief that the dedicated skill was not available. |
| 84 | |
| 85 | 6. **Provincial return** |
| 86 | - For all provinces except Quebec: provincial tax is calculated on the federal T1 (Form 428 for the province) |
| 87 | - For Quebec: separate TP-1 provincial return is required -- flag as Q4 stub. If the user is in Quebec, compute federal figures only and flag that the TP-1 must be prepared separately. |
| 88 | - Output: provincial tax payable, provincial credits, surtaxes (Ontario surtax if applicable) |
| 89 | - **Status check:** Provincial returns are Q4 stubs. Compute provincial tax using the province's rate schedule and flag in the reviewer brief that the dedicated skill was not available. |
| 90 | |
| 91 | If any upstream content skill fails to produce validated output, the assembly skill notes the failure in the reviewer brief and continues with available data rather than halting entirely. |
| 92 | |
| 93 | --- |
| 94 | |
| 95 | ## Section 3 -- Cross-skill reconciliation |
| 96 | |
| 97 | ### Cross-check 1: GST34 revenue = T2125 gross business income (net of GST/HST) |
| 98 | |
| 99 | | GST34 Output | T2125 Input | Rule | |
| 100 | |-------------|-------------|------| |
| 101 | | Line 101 total revenue | T2125 line 8299 gross revenue | Must match within $1 | |
| 102 | | Revenue is reported ex-GST/HST on GST34 line 101 | T2125 gross revenue is also ex-GST/HST | Both should be the same figure | |
| 103 | | Non-registered: no GST34 | T2125 line 8299 = gross receipts (no GST separation) | Direct match | |
| 104 | |
| 105 | **If mismatch:** Flag for reviewer. Common causes: timing differences (cash vs accrual), GST/HST-exempt supplies, zero-rated supplies, personal amounts mixed into business account. |
| 106 | |
| 107 | ### Cross-check 2: T2125 net income feeds CPP pensionable earnings |
| 108 | |
| 109 | | CPP Input | Source | Rule | |
| 110 | |----------|--------|------| |
| 111 | | Pensionable self-employment earnings | T2125 line 9946 (net income) | Minus $3,500 basic exemption | |
| 112 | | If also employed | T4 Box 26 (CPP pensionable earnings) | Reduces self-employed CPP if combined exceeds YMPE | |
| 113 | | YMPE (2025) | $71,300 (estimated -- confirm when CRA publishes) | Maximum pensionable earnings | |
| 114 | | YAMPE (2025) | $81,200 (estimated -- confirm when CRA publishes) | CPP2 second ceiling | |
| 115 | |
| 116 | **If mismatch:** Verify T2125 net income is the correct figure. If taxpayer has both employment and self-employment income, combined CPP pensionable earnings are capped at YMPE. |
| 117 | |
| 118 | ### Cross-check 3: CPP half deducted from net income, half as credit |
| 119 | |
| 120 | | CPP Treatment | T1 Line | Rule | |
| 121 | |--------------|---------|------| |
| 122 | | Employee portion (half of self-employed CPP) | Line 22200 (deduction from net income) | Reduces net income before taxable income | |
| 123 | | Employer portion (other half) | Schedule 8, then line 31000 (non-refundable credit) | 15% federal credit | |
| 124 | | CPP2 employee portion | Line 22215 | Additional deduction | |
| 125 | | CPP2 employer portion | Schedule 8 | Additional credit | |
| 126 | |
| 127 | **If inconsistency:** The total CPP self-employed = 2 x employee rate. Half goes to line 22200, half to Schedule 8. Verify the split is correct. |
| 128 | |
| 129 | ### Cross-check 4: Instalments credit against final balance owing |
| 130 | |
| 131 | | Instalment Input | Source | Rule | |
| 132 | |-----------------|--------|------| |
| 133 | | Instalments paid during 2025 | Bank statement / CRA My Account | T1 line 47600 (tax paid by instalments) | |
| 134 | | Tax deducted at source (T4) | T4 Box 22 | T1 line 43700 | |
| 135 | | Total credits | Sum of above | Reduces balance owing | |
| 136 | | Balance owing / refund | Line 48500 | Net tax owing minus all credits | |
| 137 | |
| 138 | **If mismatch:** Common cause is missed instalment payments, or instalment amounts that don't match CRA's records. Verify against CRA My Account instalment statement. |
| 139 | |
| 140 | ### Cross-check 5: Provincial tax consistency |
| 141 | |
| 142 | | Provincial Item | Source | Rule | |
| 143 | |----------------|--------|------| |
| 144 | | Taxable income | T1 line 26000 | Same for federal and provincial (except QC) | |
| 145 | | Provincial rate schedule | Province established at intake | Applied to taxable income | |
| 146 | | Provincial credits | Province-specific | BPA, provincial surtax (ON), etc. | |
| 147 | | For Quebec | Separate TP-1 | Different taxable income calculation | |
| 148 | |
| 149 | **If inconsistency:** Verify province was correctly established. If taxpayer moved provinces during the year, province on December 31 determines which provincial tax applies. |
| 150 | |
| 151 | --- |
| 152 | |
| 153 | ## Section 4 -- Final reviewer package contents |
| 154 | |
| 155 | ### Documents |
| 156 | |
| 157 | 1. **Executive summary** -- one-page overview: filing status, business income, taxable income, federal tax, provincial tax, CPP/EI, RRSP, instalments, balance due/refund |
| 158 | 2. **GST34 worksheet** -- line-by-line with formulas (revenue, GST/HST collected, ITCs, net tax) |
| 159 | 3. **T2125 worksheet** -- line-by-line with formulas (revenue, expenses, CCA, home office, vehicle, net income) |
| 160 | 4. **T1 worksheet** -- line-by-line with formulas (total income, deductions, taxable income, federal tax, credits, balance) |
| 161 | 5. **CCA schedule** -- Class, UCC opening, additions, immediate expensing, CCA claimed, UCC closing |
| 162 | 6. **CPP/CPP2/EI worksheet** -- pensionable earnings, rates, amounts, deduction/credit split |
| 163 | 7. **Provincial tax worksheet** -- rate schedule applied, credits, surtax, total provincial tax |
| 164 | 8. **Instalment schedule** -- 2026 quarterly amounts and dates |
| 165 | 9. **Cross-skill reconciliation summary** -- all five cross-checks with pass/fail and notes |
| 166 | 10. **Reviewer brief** -- comprehensive narrative with positions, citations, flags, self-check results |
| 167 | 11. **Client action list** -- what the client needs to do, with dates and amounts |
| 168 | |
| 169 | ### Reviewer brief contents |
| 170 | |
| 171 | ```markdown |
| 172 | # Complete Return Package: [Client Name] -- Tax Year 2025 |
| 173 | |
| 174 | ## Executive Summary |
| 175 | - Filing status: [Single / Married / Common-law] |
| 176 | - Residence: Canada (full-year), [Province] |
| 177 | - Business: Sole proprietor, unincorporated |
| 178 | - GST/HST registration: Yes / No (rate: GST 5% / HST 13% / HST 15% / etc.) |
| 179 | - Gross business revenue (ex-GST/HST): $X |
| 180 | - T2125 net business income: $X |
| 181 | - Total income (line 15000): $X |
| 182 | - RRSP deduction: $X |
| 183 | - Net income (line 23600): $X |
| 184 | - Taxable income (line 26000): $X |
| 185 | - Federal tax: $X |
| 186 | - Provincial tax: $X |
| 187 | - CPP self-employed: $X (+ CPP2: $X) |
| 188 | - Total payable (line 43500): $X |
| 189 | - Tax deducted / instalments paid: $X |
| 190 | - Balance owing / refund (line 48500): $X |
| 191 | - 2026 instalment total: $X |
| 192 | |
| 193 | ## GST/HST Return (GST34) |
| 194 | [Content from canada-gst-hst output] |
| 195 | - Registration status and reporting period (annual / quarterly / monthly) |
| 196 | - Line 101: total revenue |
| 197 | - Line 105: GST/HST collected |
| 198 | - Line 108: input tax credits |
| 199 | - Line 109: net tax owing / refund |
| 200 | - Quick method election (if applicable) |
| 201 | - Any adjustments |
| 202 | |
| 203 | ## T2125 -- Statement of Business or Professional Activities |
| 204 | [Content from ca-fed-t2125 output] |
| 205 | - Line 8299: gross revenue |
| 206 | - Expense schedule by category (advertising, meals 50%, insurance, office, supplies, etc.) |
| 207 | - Line 9368: total expenses |
| 208 | - Part 7: home office calculation (if claimed) |
| 209 | - Part 8: motor vehicle expenses (if claimed) |
| 210 | - CCA schedule (Class, rate, UCC, additions, CCA, closing UCC) |
| 211 | - Immediate expensing (AIIP) items |
| 212 | - Line 9946: net income (or loss) |
| 213 | |
| 214 | ## T1 -- Federal Individual Return |
| 215 | [Content from ca-fed-t1-return output] |
| 216 | - Line 10100: employment income (T4) |
| 217 | - Line 13500: gross self-employment income |
| 218 | - Line 13700: net self-employment income |
| 219 | - Line 15000: total income |
| 220 | - Line 20800: RRSP deduction |
| 221 | - Line 21200: union/professional dues |
| 222 | - Line 22200: CPP deduction on self-employment earnings |
| 223 | - Line 22215: CPP2 deduction |
| 224 | - Line 23600: net income |
| 225 | - Line 25000: other payments deduction |
| 226 | - Line 26000: taxable income |
| 227 | - Federal tax calculation (rate schedule applied) |
| 228 | - Line 30000: basic personal amount ($16,129 for 2025 -- confirm) |
| 229 | - Line 31000: CPP contributions through employment + employer portion credit |
| 230 | - Other non-refundable credits |
| 231 | - Line 35000: total federal non-refundable credits |
| 232 | - Line 42000: net federal tax |
| 233 | - Line 42100: provincial tax (from Form 428) |
| 234 | - Line 43500: total payable |
| 235 | - Line 43700: tax deducted (T4 Box 22) |
| 236 | - Line 47600: tax paid by instalments |
| 237 | - Line 48200: total credits |
| 238 | - Line 48500: balance owing / refund |
| 239 | |
| 240 | ## CPP / CPP2 / EI |
| 241 | [Content from ca-fed-cpp-ei output] |
| 242 | - T2125 net income: $X |
| 243 | - Less basic exemption: $3,500 |
| 244 | - Pensionable self-employment earnings: $X |
| 245 | - CPP rate (self-employed): 11.90% (2 x 5.95%) |
| 246 | - CPP payable: $X |
| 247 | - CPP from employment (T4 Box 16): $X -- reduces self-employed portion |
| 248 | - CPP2 earnings (between YMPE and YAMPE): $X |
| 249 | - CPP2 rate (self-employed): 8% (2 x 4%) |
| 250 | - CPP2 payable: $X |
| 251 | - EI: opted in / not opted in |
| 252 | - Split: half deduction (line 22200), half credit (Schedule 8) |
| 253 | |
| 254 | ## Provincial Tax -- [Province] |
| 255 | - Taxable income: $X (same as federal line 26000) |
| 256 | - Provincial rate schedule applied |
| 257 | - Provincial basic personal amount |
| 258 | - Provincial surtax (Ontario: if basic provincial tax > threshold) |
| 259 | - Provincial credits |
| 260 | - Total provincial tax: $X |
| 261 | |
| 262 | ## Instalment Schedule -- 2026 |
| 263 | [Content from ca-fed-instalments output] |
| 264 | - 2025 net tax owing (instalment base): $X |
| 265 | - Threshold: $3,000 ($1,800 QC) -- instalments required? Yes / No |
| 266 | - Method: prior-year / current-year / no-calculation |
| 267 | - Quarterly amounts: |
| 268 | - March 15, 2026: $X |
| 269 | - June 15, 2026: $X |
| 270 | - September 15, 2026: $X |
| 271 | - December 15, 2026: $X |
| 272 | - Total: $X |
| 273 | |
| 274 | ## Cross-skill Reconciliation |
| 275 | - GST34 revenue vs T2125 gross income: [pass/fail] |
| 276 | - T2125 net income vs CPP pensionable earnings: [pass/fail] |
| 277 | - CPP deduction/credit split correct: [pass/fail] |
| 278 | - Instalments credited on T1: [pass/fail] |
| 279 | - Provincial tax on correct taxable income: [pass/fail] |
| 280 | |
| 281 | ## Reviewer Attention Flags |
| 282 | [Aggregated from all upstream skills] |
| 283 | - T2 items requiring CPA confirmation |
| 284 | - Mixed-use expense percentages (motor vehicle, phone, internet) |
| 285 | - Home office deduction (s18(12) conditions met?) |
| 286 | - CCA / immediate expensing elections |
| 287 | - RRSP contribution vs deduction limit |
| 288 | - Vehicle kilometre log adequacy |
| 289 | - Meals/entertainment 50% limitation applied correctly |
| 290 | - Quebec residents: TP-1 required separately (Q4 stub) |
| 291 | - Any revenue approaching $30K GST/HST registration threshold (if not registered) |
| 292 | |
| 293 | ## Positions Taken |
| 294 | [List with legislation citations] |
| 295 | - e.g., "Home office deduction claimed -- workspace is principal place of business per s18(12)(a) ITA" |
| 296 | - e.g., "Motor vehicle business use at X% -- based on full-year km log per s18(1)(r) ITA" |
| 297 | - e.g., "Dell laptop immediate expensing under AIIP -- s1104(2) ITR, CCPC/unincorporated limit" |
| 298 | - e.g., "Meals and entertainment at 50% -- s67.1(1) ITA" |
| 299 | - e.g., "RRSP deduction $X -- within limit per s146(5) ITA, s146(5.1) unused room" |
| 300 | - e.g., "CPP self-employed -- s10(1) CPP Act, both employee and employer portions" |
| 301 | |
| 302 | ## Planning Notes for 2026 |
| 303 | - Instalment schedule (quarterly amounts and dates) |
| 304 | - RRSP contribution room generated by 2025 earned income (18% of line 23600, max $X) |
| 305 | - CCA/UCC schedule continuing into 2026 |
| 306 | - GST/HST registration threshold monitoring (if approaching $30K) |
| 307 | - CPP/CPP2 rate changes for 2026 (if announced) |
| 308 | - Any legislative changes affecting 2026 (budget measures, rate changes) |
| 309 | - TFSA contribution room (not computed but noted for planning) |
| 310 | |
| 311 | ## Client Action List |
| 312 | |
| 313 | ### Immediate (before April 30, 2026 -- T1 balance owing payment deadline): |
| 314 | 1. Review this return package with your CPA |
| 315 | 2. Pay balance owing of $X to CRA by April 30, 2026 (even though filing deadline is June 15) |
| 316 | 3. Pay any GST/HST balance owing |
| 317 | |
| 318 | ### Note on filing deadlines: |
| 319 | - Self-employed T1 filing deadline: June 15, 2026 |
| 320 | - BUT: balance owing is due April 30, 2026 (interest accrues after this date) |
| 321 | - GST34 filing deadline: June 15, 2026 (if annual filer and self-employed) |
| 322 | - Quebec TP-1 (if applicable): June 15, 2026 |
| 323 | |
| 324 | ### Instalment schedule for 2026: |
| 325 | - March 15, 2026: $X |
| 326 | - June 15, 2026: $X |
| 327 | - September 15, 2026: $X |
| 328 | - December 15, 2026: $X |
| 329 | |
| 330 | ### GST/HST filing calendar (if annual filer): |
| 331 | - 2026 GST34 due: June 15, 2027 |
| 332 | |
| 333 | ### RRSP: |
| 334 | - 2026 RRSP contribution deadline: March 1, 2027 |
| 335 | - Projected 2026 RRSP deduction limit: $X (from 2025 earned income) |
| 336 | |
| 337 | ### Ongoing: |
| 338 | 1. Issue invoices with GST/HST for all sales (if registered) |
| 339 | 2. Retain all records for 6 years from end of the tax year |
| 340 | 3. Maintain motor vehicle kilometre log |
| 341 | 4. Track home office hours/expenses if claiming |
| 342 | 5. Monitor revenue for GST/HST $30K threshold (if not registered) |
| 343 | 6. Review instalment amounts -- vary if income changes significantly |
| 344 | 7. Lodge s290-170 equivalent: N/A for Canada (no separate notice required for RRSP -- just claim on return within limit) |
| 345 | ``` |
| 346 | |
| 347 | --- |
| 348 | |
| 349 | ## Section 5 -- Refusals |
| 350 | |
| 351 | **R-CA-1 -- Upstream skill did not run.** Name the specific skill. Note: this is a warning, not a hard stop. Continue with available data and flag the gap. |
| 352 | |
| 353 | **R-CA-2 -- Upstream self-check failed.** Name the specific check and note it in the reviewer brief. Continue. |
| 354 | |
| 355 | **R-CA-3 -- Cross-skill reconciliation failed.** Name the specific reconciliation and describe the discrepancy. Flag for reviewer but continue. |
| 356 | |
| 357 | **R-CA-4 -- Intake incomplete.** Specific missing intake items prevent computation. List what is missing and ask the user for the specific data point. |
| 358 | |
| 359 | **R-CA-5 -- Out-of-scope item discovered during assembly.** E.g., rental income requiring Form T776, capital gains requiring Schedule 3, foreign income requiring Form T2209. Flag and exclude from computation. |
| 360 | |
| 361 | **R-CA-6 -- Quebec resident.** TP-1 provincial return is required but is a Q4 stub. Federal return is computed; provincial return must be prepared separately by the reviewer. |
| 362 | |
| 363 | --- |
| 364 | |
| 365 | ## Section 6 -- Self-checks |
| 366 | |
| 367 | **Check CA1 -- All upstream skills executed.** canada-gst-hst, ca-fed-t2125, ca-fed-t1-return, ca-fed-cpp-ei all produced output. ca-fed-instalments produced output or was computed from T1 figures. Provincial tax was computed or flagged as stub. |
| 368 | |
| 369 | **Check CA2 -- GST34 revenue matches T2125 gross income.** Within $1 tolerance. |
| 370 | |
| 371 | **Check CA3 -- T2125 net income feeds CPP correctly.** Pensionable earnings = T2125 line 9946 minus $3,500 basic exemption, capped at YMPE minus any employment pensionable earnings. |
| 372 | |
| 373 | **Check CA4 -- CPP split correct.** Half (employee portion) deducted at line 22200; half (employer portion) credited via Schedule 8 at line 31000. |
| 374 | |
| 375 | **Check CA5 -- Instalments correctly credited.** Total instalments paid during 2025 credited at T1 line 47600. |
| 376 | |
| 377 | **Check CA6 -- GST/HST treatment correct for registered filers.** Business income reported net of GST/HST; ITCs excluded from deductible expenses; GST/HST collected remitted via GST34. |
| 378 | |
| 379 | **Check CA7 -- GST/HST treatment correct for small suppliers.** Business income reported gross; all expenses reported gross; no GST34 required. |
| 380 | |
| 381 | **Check CA8 -- CCA/immediate expensing correctly applied.** AIIP items fully expensed if elected; standard CCA items depreciated at correct class rates; half-year rule applied where required. |
| 382 | |
| 383 | **Check CA9 -- RRSP deduction within limit.** Deduction claimed does not exceed lesser of (contribution amount, deduction limit from prior NOA). |
| 384 | |
| 385 | **Check CA10 -- Meals and entertainment at 50%.** s67.1 limitation applied to all meals and entertainment expenses. |
| 386 | |
| 387 | **Check CA11 -- Fiscal year end is December 31.** Sole proprietors must use December 31 year-end unless they were in business before 1995 and elected an alternative year-end. |
| 388 | |
| 389 | **Check CA12 -- Filing calendar is complete.** All deadlines for GST34, T1, instalments, and RRSP are listed with specific dates and amounts. |
| 390 | |
| 391 | **Check CA13 -- Provincial tax uses correct province.** Province on December 31 determines provincial tax; correct rate schedule applied. |
| 392 | |
| 393 | --- |
| 394 | |
| 395 | ## Section 7 -- Output files |
| 396 | |
| 397 | The final output is **three files**: |
| 398 | |
| 399 | 1. **`[client_slug]_2025_canada_master.xlsx`** -- Single master workbook containing every worksheet and form. Sheets include: Cover, GST34 (line-by-line), T2125 (line-by-line), T1 Summary (line-by-line), CCA Schedule, Expense Detail, CPP/EI Calculation, Provincial Tax, Instalment Schedule, Cross-Check Summary. Use live formulas where possible -- e.g., T1 line 13700 references T2125 line 9946; CPP pensionable earnings reference T2125 net income; instalment amounts reference T1 net tax. Verify no `#REF!` errors. Verify computed values match the computation model within $1 before shipping. |
| 400 | |
| 401 | 2. **`reviewer_brief.md`** -- Single markdown file covering all sections from Section 4 above: executive summary, GST34, T2125, T1, CPP/EI, provincial tax, instalments, cross-skill reconciliation, flags, positions, planning notes. |
| 402 | |
| 403 | 3. **`client_action_list.md`** -- Single markdown file with step-by-step actions: immediate filings and payments, quarterly instalment calendar for 2026, ongoing compliance reminders. |
| 404 | |
| 405 | **If execution runs out of context mid-build:** produce whatever is complete, then state at the end which of the three files were not produced or are partial. |
| 406 | |
| 407 | **All files are placed in `/mnt/user-data/outputs/` and presented to the user via the `present_files` tool at the end.** |
| 408 | |
| 409 | --- |
| 410 | |
| 411 | ## Section 8 -- Cross-skill references |
| 412 | |
| 413 | **Inputs:** |
| 414 | - `ca-freelance-intake` -- structured intake package (JSON) |
| 415 | - `canada-gst-hst` -- GST34 line values and classification output |
| 416 | - `ca-fed-t2125` -- T2125 line values and computation output |
| 417 | - `ca-fed-t1-return` -- T1 line values and computation output |
| 418 | - `ca-fed-cpp-ei` -- CPP/CPP2/EI calculation output |
| 419 | - `ca-fed-instalments` -- Instalment schedule (or fallback computation) |
| 420 | - Provincial return -- Form 428 or TP-1 (Quebec) |
| 421 | |
| 422 | **Outputs:** The final reviewer package. No downstream skill. |
| 423 | |
| 424 | --- |
| 425 | |
| 426 | ## Section 9 -- Known gaps |
| 427 | |
| 428 | 1. PDF form filling is not automated. The reviewer uses the worksheets to file via NETFILE, EFILE, or paper. |
| 429 | 2. E-filing is handled by the reviewer via certified tax software, not by this skill. |
| 430 | 3. Payment execution is the client's responsibility; the skill only provides instructions and amounts. |
| 431 | 4. Quebec TP-1 provincial return is a Q4 stub. Quebec residents get the federal package only; TP-1 must be prepared separately. |
| 432 | 5. Rental income (T776) is not supported -- if rental income exists, the skill flags it but the T776 must be completed separately by the reviewer. |
| 433 | 6. Capital gains (Schedule 3) are not supported -- if capital gains exist, the skill flags it but Schedule 3 must be completed separately. |
| 434 | 7. Foreign income and foreign tax credit (T2209) are out of scope. |
| 435 | 8. Multi-year CCA tracking assumes the prior year schedule is provided. If not, only current-year acquisitions are depreciated. |
| 436 | 9. Several upstream content skills are Q2 skills. If any are still stubs, the assembly skill computes the figures directly and flags the gap. |
| 437 | 10. ca-fed-instalments is a Q4 stub. Until it is fleshed out, instalments are computed using the prior-year method. This is a redundancy, not a gap -- the rules are deterministic. |
| 438 | 11. Provincial returns for all provinces except Quebec are computed from the federal rate schedules. Dedicated provincial skills are Q4 stubs. |
| 439 | 12. The package is complete only for the 2025 tax year; 2026 appears only as prospective planning. |
| 440 | 13. EI self-employed opt-in is flagged but not deeply modelled -- if the taxpayer has opted in, the reviewer should verify special benefit eligibility. |
| 441 | |
| 442 | ### Change log |
| 443 | - **v0.1 (April 2026):** Initial draft. Modelled on mt-return-assembly v0.1 adapted for Canadian jurisdiction with five content skills plus provincial tax (GST34, T2125, T1, CPP/EI, instalments, provincial). |
| 444 | |
| 445 | ## End of skill |
| 446 | |
| 447 | |
| 448 | --- |
| 449 | |
| 450 | ## Disclaimer |
| 451 | |
| 452 | This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a CPA, EA, tax attorney, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon. |
| 453 | |
| 454 | The most up-to-date, verified version of this skill is maintained at [openaccountants.com](https://openaccountants.com). Log in to access the latest version, request a professional review from a licensed accountant, and track updates as tax law changes. |
| 455 |
Run this skill, then get an accountant to check it
After running the full skill pack in Claude, sign up and upload your worksheet. We'll connect you with a trusted accountant in our network who can review your numbers before you file.
Depends on
Quality
Q2: Research-verified
Deep research against tax authority sources. Not yet tested on real data.
Needs real client data + practitioner sign-off to reach Q1.
Accountant Review
Unverified
0/37
About
Final orchestrator skill that assembles the complete Canadian filing package for Canadian-resident sole proprietors. Consumes outputs from all Canadian content skills (canada-gst-hst for GST34, ca-fed-t2125 for business income, ca-fed-t1-return for federal return, ca-fed-cpp-ei for CPP/CPP2/EI, ca-fed-instalments for instalment schedule) to produce a single unified reviewer package containing every worksheet, every form, every brief section, all cross-skill reconciliations, and the final action list with payment instructions, filing instructions, and next-year planning. This is the capstone skill that runs last and produces the final deliverable. MUST be loaded alongside all Canadian content skills listed above. Canadian full-year residents only. Sole proprietors only (not incorporated).
CAty-2025