us-ca-return-assembly.md305 lines14.8 KB
v1Orchestrator
| 1 | --- |
| 2 | name: us-ca-return-assembly |
| 3 | description: Final orchestrator skill that assembles the complete federal and California filing package for California resident sole proprietors and single-member LLCs disregarded for federal tax. Consumes outputs from all federal content skills (bookkeeping, Schedule C/SE, QBI, retirement, SE health insurance, quarterly estimated tax, federal assembly, 1099-NEC) and all California content skills (540 individual return, 540-ES estimated tax, 568 SMLLC where applicable, 3853 coverage) to produce a single unified reviewer package containing every worksheet, every form, every brief section, all cross-skill reconciliations, and the final taxpayer action list with payment instructions, filing instructions, and 2026 planning. This is the capstone skill that runs last and produces the final deliverable. MUST be loaded alongside us-tax-workflow-base v0.2 or later and all content skills listed above. California residents only. |
| 4 | version: 0.2 |
| 5 | --- |
| 6 | |
| 7 | # US+CA Return Assembly Skill v0.2 |
| 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 a tax return. They want the tax return. Produce it. |
| 16 | - **Do NOT announce how many tokens or tool calls this will take.** The user does not care about your tool budget. Execute. |
| 17 | - **Do NOT ask which deliverables to prioritize.** Produce all deliverables listed in Section 8. 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. Partial output with an honest status beats a question asking permission. |
| 18 | - **Do NOT re-validate scope that intake already validated.** If `us-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 filing status, 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; per-skill status is noise. |
| 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 in one content skill had an ambiguous answer. The reviewer handles edge cases. |
| 21 | - **Primary source citations go in the final reviewer brief, not in intermediate computation steps.** Don't stop to cite §199A in the middle of computing QBI. Compute QBI, then cite §199A once in the brief's QBI section. |
| 22 | |
| 23 | **The user has already been told (by the intake skill) that the final package requires credentialed reviewer signoff before filing. You do not need to reiterate this before every step. 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. This is disqualifying behavior. 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. Every other skill feeds into this one. The output is the complete reviewer package that a credentialed reviewer (Enrolled Agent, CPA, or attorney under Circular 230) can review, sign off on, and deliver to the taxpayer along with filing instructions. |
| 32 | |
| 33 | This skill does not compute anything new. Its job is to verify that every upstream skill ran, every upstream self-check passed, every cross-skill reconciliation holds, and the entire package is internally consistent. |
| 34 | |
| 35 | --- |
| 36 | |
| 37 | ## Section 1 — Scope |
| 38 | |
| 39 | Produces the complete federal + California filing package for: |
| 40 | - Full-year California residents |
| 41 | - Sole proprietors or single-member LLCs disregarded for federal tax |
| 42 | - Tax year 2025 |
| 43 | - Filing Form 1040 and Form 540 (and Form 568 if SMLLC) |
| 44 | |
| 45 | --- |
| 46 | |
| 47 | ## Section 2 — Execution order enforcement |
| 48 | |
| 49 | The skill enforces the following execution order and refuses to proceed if any step is missing: |
| 50 | |
| 51 | 1. `us-sole-prop-bookkeeping` |
| 52 | 2. `us-schedule-c-and-se-computation` |
| 53 | 3. `us-self-employed-retirement` |
| 54 | 4. `us-self-employed-health-insurance` |
| 55 | 5. `us-qbi-deduction` |
| 56 | 6. `us-federal-return-assembly` |
| 57 | 7. `us-quarterly-estimated-tax` (needs federal total tax) |
| 58 | 8. `us-1099-nec-issuance` (parallel, only needs bookkeeping) |
| 59 | 9. `ca-540-individual-return` (needs federal assembly) |
| 60 | 10. `ca-smllc-form-568` (if SMLLC; parallel with 540) |
| 61 | 11. `ca-estimated-tax-540es` (needs CA 540 total tax) |
| 62 | 12. `ca-form-3853-coverage` (parallel, needs coverage intake) |
| 63 | 13. **THIS SKILL** — final assembly and verification |
| 64 | |
| 65 | If any of the above has not produced validated output, the skill refuses with a specific message identifying the missing step. |
| 66 | |
| 67 | --- |
| 68 | |
| 69 | ## Section 3 — Verification matrix |
| 70 | |
| 71 | The skill runs a comprehensive verification pass across all upstream outputs: |
| 72 | |
| 73 | ### Federal internal consistency |
| 74 | - Schedule C net profit → Schedule 1 Line 3 → Form 1040 Line 8 |
| 75 | - Schedule SE SE tax → Schedule 2 Line 4 → Form 1040 Line 23 |
| 76 | - Half of SE tax → Schedule 1 Line 15 → Form 1040 Line 10 |
| 77 | - SE retirement → Schedule 1 Line 16 → Form 1040 Line 10 |
| 78 | - SE health insurance → Schedule 1 Line 17 → Form 1040 Line 10 |
| 79 | - QBI deduction → Form 1040 Line 13 |
| 80 | - Total tax → Form 1040 Line 24 |
| 81 | - Form 2210 penalty → Schedule 2 Line 8 |
| 82 | - Total payments → Form 1040 Line 33 |
| 83 | |
| 84 | ### California internal consistency |
| 85 | - Federal AGI → Schedule CA (540) starting point |
| 86 | - QBI add-back → Schedule CA (540) additions |
| 87 | - HSA add-back if applicable → Schedule CA (540) additions |
| 88 | - Bonus depreciation add-back → Schedule CA (540) additions |
| 89 | - §179 cap difference → Schedule CA (540) additions |
| 90 | - California AGI → Form 540 Line 17 |
| 91 | - California tax → Form 540 Line 31 |
| 92 | - MHST → Form 540 Line 62 if applicable |
| 93 | - Form 5805 penalty → Form 540 Line 113 |
| 94 | - Form 3853 penalty → Form 540 Line 92 |
| 95 | - Form 568 balance (if SMLLC) → separate from Form 540 |
| 96 | |
| 97 | ### Federal-California coordination |
| 98 | - Filing status consistent (MFJ federal + MFJ California) |
| 99 | - Dependents consistent |
| 100 | - Deduction election (standard vs itemized) may differ but must be documented |
| 101 | - Schedule C net profit used federally and on California Schedule CA match |
| 102 | - Depreciation recomputed for California if bonus or §179 differences exist |
| 103 | |
| 104 | ### 1099 issuance reconciliation |
| 105 | - Payments flagged for 1099-NEC match Schedule C Line 11 (Contract Labor) and related lines |
| 106 | - W-9 collection gaps identified |
| 107 | - Filing deadline noted (January 31, 2026) |
| 108 | |
| 109 | --- |
| 110 | |
| 111 | ## Section 4 — Final reviewer package contents |
| 112 | |
| 113 | ### Documents |
| 114 | 1. **Executive summary** — one-page overview: filing status, income, federal tax, state tax, total liability, refund/balance due |
| 115 | 2. **Federal Form 1040 worksheet** — line-by-line with formulas |
| 116 | 3. **Schedule 1** — adjustments to income |
| 117 | 4. **Schedule 2** — additional taxes |
| 118 | 5. **Schedule 3** — credits and payments (if applicable) |
| 119 | 6. **Schedule C** — sole prop P&L |
| 120 | 7. **Schedule SE** — SE tax |
| 121 | 8. **Form 8995 or 8995-A** — QBI |
| 122 | 9. **Form 7206** — SE health insurance worksheet |
| 123 | 10. **Form 8962** — PTC reconciliation (if marketplace coverage) |
| 124 | 11. **Form 2210** — underpayment penalty (if applicable) |
| 125 | 12. **Form 4562** — depreciation (if applicable) |
| 126 | 13. **Form 8829** — home office actual method (if applicable) |
| 127 | 14. **Form 1040-ES** — 2026 prospective payment schedule |
| 128 | 15. **California Form 540** — state return worksheet |
| 129 | 16. **California Schedule CA (540)** — state adjustments |
| 130 | 17. **California Form 5805** — state underpayment penalty (if applicable) |
| 131 | 18. **California Form 3853** — individual mandate (if applicable) |
| 132 | 19. **California Form 540-ES** — 2026 state prospective payment schedule |
| 133 | 20. **California Form 568** — SMLLC return (if applicable) |
| 134 | 21. **Form 3522** — $800 LLC tax voucher (if applicable) |
| 135 | 22. **Form 3536** — LLC fee estimation voucher (if applicable) |
| 136 | 23. **1099-NEC batch** — contractor information returns (if applicable) |
| 137 | 24. **Reviewer brief** — comprehensive narrative with positions, citations, flags, self-check results |
| 138 | 25. **Taxpayer action list** — what the taxpayer needs to do, with dates and amounts |
| 139 | |
| 140 | ### Reviewer brief contents |
| 141 | |
| 142 | ```markdown |
| 143 | # Complete Return Package: [Taxpayer Name] — Tax Year 2025 |
| 144 | |
| 145 | ## Executive Summary |
| 146 | - Filing status: [X] |
| 147 | - Residence: California (full-year) |
| 148 | - Business: Sole proprietor / Single-member LLC disregarded |
| 149 | - Federal total tax: $X |
| 150 | - California total tax: $X |
| 151 | - Total 2025 tax liability: $X |
| 152 | - Total payments (federal + CA): $X |
| 153 | - Net refund or balance due: $X |
| 154 | - Action required by April 15, 2026: [summary] |
| 155 | |
| 156 | ## Federal Return |
| 157 | [Content from us-federal-return-assembly brief] |
| 158 | |
| 159 | ## California Return |
| 160 | [Content from ca-540-individual-return brief] |
| 161 | |
| 162 | ## California SMLLC (if applicable) |
| 163 | [Content from ca-smllc-form-568 brief] |
| 164 | |
| 165 | ## Individual Mandate |
| 166 | [Content from ca-form-3853-coverage brief] |
| 167 | |
| 168 | ## Estimated Tax |
| 169 | [Content from us-quarterly-estimated-tax brief] |
| 170 | [Content from ca-estimated-tax-540es brief] |
| 171 | |
| 172 | ## 1099 Issuance |
| 173 | [Content from us-1099-nec-issuance brief] |
| 174 | |
| 175 | ## Cross-skill verification |
| 176 | - All upstream skills ran: [verified] |
| 177 | - All upstream self-checks passed: [verified] |
| 178 | - All cross-form reconciliations passed: [verified] |
| 179 | - Specific checks: [list] |
| 180 | |
| 181 | ## Reviewer attention flags |
| 182 | [Aggregated from all upstream skills] |
| 183 | |
| 184 | ## Refusals triggered |
| 185 | [Any refusals from any skill in the chain] |
| 186 | |
| 187 | ## Positions taken |
| 188 | [Aggregated list with citations] |
| 189 | |
| 190 | ## Planning notes for 2026 |
| 191 | - Federal estimated tax schedule |
| 192 | - California estimated tax schedule |
| 193 | - S-corp election consideration (if applicable) |
| 194 | - 2026 rate changes (QBI 20% → 23%, 1099 threshold $600 → $2,000) |
| 195 | - Expanded PTC expiration after 2025 |
| 196 | - Retirement contribution planning |
| 197 | - W-9 collection for contractors |
| 198 | - Other |
| 199 | |
| 200 | ## Taxpayer action list |
| 201 | |
| 202 | ### Before April 15, 2026: |
| 203 | 1. Review and sign this return package |
| 204 | 2. Sign Form 8879 (e-file authorization) — if e-filing |
| 205 | 3. Pay federal balance due of $X via EFTPS, Direct Pay, or check |
| 206 | 4. Pay California balance due of $X via FTB Web Pay or check |
| 207 | 5. File Form 568 and pay $800 LLC tax + $X LLC fee (if applicable) |
| 208 | 6. Pay 2026 Q1 federal estimated tax of $X |
| 209 | 7. Pay 2026 Q1 California estimated tax of $X (30% installment) |
| 210 | |
| 211 | ### Before January 31, 2026 (ALREADY PASSED — check if done): |
| 212 | 1. File 1099-NEC forms with IRS (IRIS or FIRE) |
| 213 | 2. Furnish Copy B to contractors |
| 214 | 3. If missed, assess penalty exposure and file ASAP |
| 215 | |
| 216 | ### Before June 15, 2026: |
| 217 | 1. Pay 2026 Q2 federal estimated tax of $X |
| 218 | 2. Pay 2026 Q2 California estimated tax of $X (40% installment) |
| 219 | 3. Pay 2026 Form 3536 LLC fee estimate of $X (if applicable) |
| 220 | |
| 221 | ### Before September 15, 2026: |
| 222 | 1. Pay 2026 Q3 federal estimated tax of $X |
| 223 | 2. California Q3 is $0 under 30/40/0/30 rule — no payment needed |
| 224 | |
| 225 | ### Before January 15, 2027: |
| 226 | 1. Pay 2026 Q4 federal estimated tax of $X |
| 227 | 2. Pay 2026 Q4 California estimated tax of $X (30% installment) |
| 228 | |
| 229 | ### Ongoing: |
| 230 | 1. Collect W-9 from new contractors before paying them |
| 231 | 2. Track business expenses with receipts |
| 232 | 3. Monitor income to adjust Solo 401(k) contribution |
| 233 | 4. Watch for mid-year health coverage changes |
| 234 | ``` |
| 235 | |
| 236 | --- |
| 237 | |
| 238 | ## Section 5 — Refusals |
| 239 | |
| 240 | **R-FINAL-1 — Upstream skill did not run.** Name the specific skill. |
| 241 | |
| 242 | **R-FINAL-2 — Upstream self-check failed.** Name the specific check. |
| 243 | |
| 244 | **R-FINAL-3 — Cross-skill reconciliation failed.** Name the specific reconciliation and describe the discrepancy. |
| 245 | |
| 246 | **R-FINAL-4 — Refusal hidden upstream.** A refusal from an upstream skill was not surfaced in its output. Name the refusal and force resolution. |
| 247 | |
| 248 | **R-FINAL-5 — Taxpayer intake incomplete.** Specific missing intake items prevent final assembly. |
| 249 | |
| 250 | --- |
| 251 | |
| 252 | ## Section 6 — Self-checks |
| 253 | |
| 254 | **Check 130 — All upstream skills executed.** |
| 255 | **Check 131 — All upstream self-checks passed.** |
| 256 | **Check 132 — Federal internal consistency verified.** |
| 257 | **Check 133 — California internal consistency verified.** |
| 258 | **Check 134 — Federal-California coordination verified.** |
| 259 | **Check 135 — 1099-NEC reconciliation verified.** |
| 260 | **Check 136 — Taxpayer action list is complete with dates and amounts.** |
| 261 | **Check 137 — Planning notes include 2026 changes (QBI rate, 1099 threshold, PTC expiration).** |
| 262 | **Check 138 — Every refusal in the catalogue was evaluated against taxpayer facts.** |
| 263 | **Check 139 — Every reviewer attention flag is surfaced.** |
| 264 | **Check 140 — Payment instructions are specific (amount, method, due date).** |
| 265 | |
| 266 | --- |
| 267 | |
| 268 | ## Section 7 — Output files |
| 269 | |
| 270 | The final output is **three files** (not eleven — do not fragment the package): |
| 271 | |
| 272 | 1. **`[taxpayer_slug]_2025_master.xlsx`** — Single master workbook containing every worksheet and form. Sheets include: Cover, Income, Schedule C (Parts I-V), Form 4562, Form 8829, Schedule SE, Retirement, SE Health, Form 8962, Form 8995-A (or 8995), Schedule 1, Form 1040, Form 2210, Form 540, Schedule CA (540), Form 5805, Form 568, Schedule IW, Form 3853, 1099-NEC batch, 2026 Est Tax. Use the Excel builder pattern specified in `us-federal-return-assembly` — collect anchors as a Python dict before writing cross-sheet formulas, verify no `#REF!` errors, verify computed values match the Python model within $1 before shipping. |
| 273 | |
| 274 | 2. **`reviewer_brief.md`** — Single markdown file covering all sections: taxpayer summary, Schedule C summary, SE tax, retirement, SE health insurance, QBI, federal tax computation, California tax computation, Form 568 (if SMLLC), cross-jurisdiction reconciliation, open flags for reviewer, self-check results, primary source citations, position statements for anything requiring reviewer judgment. |
| 275 | |
| 276 | 3. **`taxpayer_action_list.md`** — Single markdown file with step-by-step actions for the taxpayer: this week (corrective actions, late 1099 filings), before reviewer finishes, by April 15 (signing, payments, estimates), and year-ahead planning items. |
| 277 | |
| 278 | **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. Three files with honest status beats eleven files partially built. |
| 279 | |
| 280 | **All files are placed in `/mnt/user-data/outputs/` and presented to the user via the `present_files` tool at the end.** |
| 281 | |
| 282 | --- |
| 283 | |
| 284 | ## Section 8 — Cross-skill references |
| 285 | |
| 286 | Inputs: every other skill in the product. |
| 287 | |
| 288 | Outputs: the final reviewer package. No downstream skill. |
| 289 | |
| 290 | --- |
| 291 | |
| 292 | ## Section 9 — Known gaps |
| 293 | |
| 294 | 1. PDF form filling is not automated. The reviewer uses the worksheets to fill official IRS/FTB forms in their tax software. |
| 295 | 2. E-filing is handled by the reviewer, not by this skill. |
| 296 | 3. Payment execution is the taxpayer's responsibility; the skill only provides instructions. |
| 297 | 4. Multi-state returns not supported (California only). |
| 298 | 5. Foreign income not supported. |
| 299 | 6. The package is complete only for the 2025 tax year; 2026 appears only as prospective planning. |
| 300 | |
| 301 | ### Change log |
| 302 | - **v0.1 (April 2026):** Initial draft. |
| 303 | |
| 304 | ## End of skill |
| 305 |
Run this skill, then get an accountant to check it
After running the full skill pack in your AI agent, 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.
Quality
Q3: AI-drafted
AI-generated with structure and citations. Not independently verified.
Needs deep research against tax authority websites to reach Q2.
Accountant Review
Accountant Verified
25/25
About
Top orchestrator assembling the complete federal + California filing package.
US-CAty-2025