Not tax advice. Computation tools only. Have a professional review before filing.
openaccountants/skills/in-return-assembly.md
in-return-assembly.md388 lines21.9 KB
v1Orchestrator
1---
2name: in-return-assembly
3description: Final orchestrator skill that assembles the complete India filing package for India-resident self-employed individuals and professionals. Consumes outputs from all India content skills (india-gst for GSTR-3B/GSTR-1, in-income-tax for ITR-3/ITR-4, in-advance-tax for quarterly instalments, in-tds-freelance for TDS reporting) 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 India content skills listed above. India full-year residents only. Self-employed individuals and professionals only.
4version: 0.1
5---
6 
7# India 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 
13Specifically:
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 `in-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 CA 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 
31The final capstone skill for India self-employed returns. Every India content skill feeds into this one. The output is the complete reviewer package that a Chartered Accountant can review, sign off on, and deliver to the client along with filing instructions.
32 
33This skill coordinates execution of the content skills, verifies cross-skill consistency, and assembles the final deliverable.
34 
35---
36 
37## Section 1 -- Scope
38 
39Produces the complete India filing package for:
40- Full-year Indian residents
41- Self-employed individuals and professionals (sole proprietors)
42- Financial year 2025-26 (Assessment year 2026-27)
43- Filing GST returns (GSTR-3B + GSTR-1 if registered), ITR-3 or ITR-4, advance tax reconciliation, TDS credit reconciliation
44 
45---
46 
47## Section 2 -- Execution order and dependency chain
48 
49The skill enforces the following execution order:
50 
511. **`india-gst`** -- GSTR-3B + GSTR-1 reconciliation (Q2 skill)
52 - Runs first because GST turnover figures feed into the ITR
53 - Reconcile GSTR-3B monthly/quarterly summaries with books
54 - Verify GSTR-1 outward supply details match invoices
55 - Reconcile ITC claimed with GSTR-2B auto-populated data
56 - Output: GST turnover, output tax, ITC utilised, cash GST paid, reverse charge
57 
582. **`in-income-tax`** -- ITR-3 or ITR-4 return (Q2 skill)
59 - Depends on GST output: gross receipts must match GST turnover (ex-GST for regular taxpayer)
60 - For ITR-4 (presumptive 44ADA): 50% deemed profit on gross receipts, no expense schedule
61 - For ITR-3 (actual profit): full P&L with expense deductions, depreciation schedule, balance sheet
62 - Output: total income, tax liability at applicable slab rates, regime comparison if requested
63 
643. **`in-advance-tax`** -- Quarterly advance tax reconciliation (Q2 skill)
65 - Depends on ITR: final tax liability determines whether advance tax was sufficient
66 - Reconcile advance tax paid (from Form 26AS) against liability
67 - Compute s.234B interest (default on advance tax shortfall -- if paid < 90% of assessed tax)
68 - Compute s.234C interest (deferment -- quarterly shortfall in instalments: 15%/45%/75%/100%)
69 - Output: advance tax schedule, shortfall computation, interest liability
70 
714. **`in-tds-freelance`** -- TDS credit reconciliation (Q4 stub, flag)
72 - Depends on ITR: TDS credits offset final tax liability
73 - Reconcile Form 26AS TDS entries with income declared in ITR
74 - Flag mismatches (TDS claimed but income not shown, or income shown but TDS not reflected)
75 - **Status check:** in-tds-freelance is currently a Q4 stub. If the stub has substantive content, use it. If it is still a placeholder, compute TDS reconciliation using Form 26AS data from intake and flag in the reviewer brief that the dedicated skill was not available.
76 - Output: TDS credit summary, mismatches, Form 26AS vs ITR reconciliation
77 
78If 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.
79 
80---
81 
82## Section 3 -- Cross-skill reconciliation
83 
84### Cross-check 1: GST turnover matches ITR gross receipts
85 
86| GST Output | ITR Input | Rule |
87|-----------|-----------|------|
88| GSTR-3B aggregate turnover (ex-GST) | ITR gross receipts from profession/business | Must match within INR 100 |
89| GSTR-1 outward supplies | ITR Schedule BP / presumptive turnover | Turnover is ex-GST for regular registrants |
90| Export of services (zero-rated) | ITR foreign income | Included in gross receipts, zero-rated for GST |
91 
92**If mismatch:** Flag for reviewer. Common causes: timing differences (invoice vs receipt basis), RCM supplies, credit notes, advances received but service not rendered.
93 
94### Cross-check 2: If 44ADA presumptive -- 50% deemed profit, no further expense deduction allowed
95 
96| Rule | Application |
97|------|------------|
98| Deemed profit = 50% of gross receipts | No deduction for actual expenses against professional income |
99| Depreciation | NOT claimable under presumptive scheme |
100| Partner remuneration / interest | Not applicable (sole proprietor) |
101| Deductions under Ch VI-A (80C, 80D) | Still allowed (old regime) or standard deduction (new regime) -- these are from total income, not business income |
102 
103**If violation:** If the computation claims actual expenses AND declares 50% deemed profit, check fails. It is one or the other.
104 
105### Cross-check 3: Advance tax paid + TDS credits against final tax liability
106 
107| Component | Source | Rule |
108|-----------|--------|------|
109| Advance tax paid | Form 26AS Part C / challans | Sum of all advance tax payments during FY |
110| TDS credits | Form 26AS Part A / TDS certificates | Sum of all TDS deducted and deposited |
111| Self-assessment tax (if any) | Challan 280 | Paid before filing ITR |
112| Total tax liability | ITR computation | Tax on total income + surcharge + cess |
113| Tax payable / refund | Liability minus (advance tax + TDS + self-assessment) | Positive = payable; negative = refund |
114 
115**If advance tax + TDS < 90% of assessed tax:** s.234B interest applies at 1% per month (simple) from April of AY to date of filing or date of assessment.
116 
117**If quarterly advance tax instalments fell short:** s.234C interest applies at 1% per month for 3 months per shortfall quarter.
118 
119| Quarter | Due date | Cumulative % required |
120|---------|----------|-----------------------|
121| Q1 | 15 June | 15% |
122| Q2 | 15 September | 45% |
123| Q3 | 15 December | 75% |
124| Q4 | 15 March | 100% |
125 
126For 44ADA presumptive: entire advance tax can be paid by 15 March (single instalment). s.234C does not apply if 100% paid by 15 March.
127 
128### Cross-check 4: Form 26AS TDS vs ITR income declaration
129 
130| Check | Rule |
131|-------|------|
132| Every TDS entry in 26AS Part A | Corresponding income must appear in ITR |
133| TDS credit claimed in ITR | Must match 26AS (or AIS) within INR 1 |
134| Mismatch entries | Flag: either TDS not deposited by deductor, or income not declared |
135| TCS entries (26AS Part C) | If applicable, credit against tax liability |
136 
137**If mismatch:** Common causes: deductor filed TDS return late, wrong PAN quoted, income accounted in different FY. Flag for reviewer with specific entries.
138 
139---
140 
141## Section 4 -- Final reviewer package contents
142 
143### Documents
144 
1451. **Executive summary** -- one-page overview: filing status, income, tax liability, GST position, advance tax, TDS credits, refund/balance due
1462. **GST reconciliation worksheet** -- GSTR-3B vs books, GSTR-1 vs invoices, ITC reconciliation
1473. **ITR computation worksheet** -- ITR-3 or ITR-4 schedule with all heads of income, deductions, tax computation
1484. **Depreciation schedule** -- asset register with block, cost, date, rate, annual allowance, WDV (ITR-3 only)
1495. **Advance tax reconciliation** -- quarterly payments vs requirement, s.234B/234C interest computation
1506. **TDS credit reconciliation** -- Form 26AS vs ITR, mismatches flagged
1517. **Cross-skill reconciliation summary** -- all four cross-checks with pass/fail and notes
1528. **Reviewer brief** -- comprehensive narrative with positions, citations, flags, self-check results
1539. **Client action list** -- what the client needs to do, with dates and amounts
154 
155### Reviewer brief contents
156 
157```markdown
158# Complete Return Package: [Client Name] -- FY 2025-26 (AY 2026-27)
159 
160## Executive Summary
161- Filing status: [Individual -- Resident]
162- Age category: [Below 60 / Senior / Super Senior]
163- Business: Self-employed professional / sole proprietor
164- Tax regime: [New regime / Old regime]
165- Presumptive: [44ADA / 44AD / Actual profit (ITR-3)]
166- ITR form: [ITR-3 / ITR-4]
167- GST registration: [Regular / Composition / Unregistered]
168- Gross receipts: INR X
169- Deemed profit (if 44ADA) / Net profit (if ITR-3): INR X
170- Total income: INR X
171- Tax liability (including surcharge + cess): INR X
172- Advance tax paid: INR X
173- TDS credits: INR X
174- Self-assessment tax paid: INR X
175- Balance due / refund: INR X
176- s.234B interest (if any): INR X
177- s.234C interest (if any): INR X
178- GST annual position: Output INR X, ITC INR X, cash paid INR X
179 
180## GST Returns
181[Content from india-gst output]
182- Registration type and state
183- Monthly/quarterly GSTR-3B summary
184- GSTR-1 outward supply reconciliation
185- ITC claimed vs GSTR-2B auto-populated
186- Reverse charge liability
187- Zero-rated exports reconciliation
188- Annual aggregate turnover
189 
190## Income Tax Return (ITR-3 / ITR-4)
191[Content from in-income-tax output]
192- Gross receipts from profession/business
193- Deemed profit (44ADA) or actual P&L (ITR-3)
194- Depreciation schedule (ITR-3 only)
195- Income under other heads (interest, capital gains, etc.)
196- Deductions under Chapter VI-A (old regime) or standard deduction (new regime)
197- Total income
198- Tax at applicable slab rates
199- Surcharge (if total income > INR 50 lakh)
200- Health and education cess (4%)
201- Relief under s.87A (if total income <= INR 12,00,000 new regime)
202- Total tax liability
203 
204## Advance Tax Reconciliation
205[Content from in-advance-tax output]
206- Quarterly advance tax payments made (dates and amounts)
207- Required quarterly cumulative percentages (15/45/75/100)
208- Shortfall computation per quarter
209- s.234B interest computation (if advance tax < 90% of assessed tax)
210- s.234C interest computation (if quarterly shortfall)
211- Total interest payable
212 
213## TDS Credit Reconciliation
214[Content from in-tds-freelance output or computed from Form 26AS]
215- Deductor-wise TDS summary
216- Section-wise TDS summary (194J, 194C, etc.)
217- Form 26AS vs ITR reconciliation
218- Mismatches and resolution notes
219- TCS credits (if any)
220 
221## Cross-skill Reconciliation
222- GST turnover vs ITR gross receipts: [pass/fail]
223- 44ADA deemed profit -- no expense deduction: [pass/fail or N/A]
224- Advance tax + TDS vs final liability: [pass/fail]
225- Form 26AS TDS vs ITR income: [pass/fail]
226 
227## Reviewer Attention Flags
228[Aggregated from all upstream skills]
229- Tax regime choice (old vs new) -- confirmation needed
230- 44ADA lock-in implications if switching from/to presumptive
231- Mixed-use expense percentages (phone, internet)
232- Home office deduction (if claimed under ITR-3)
233- Export of services zero-rating -- FIRC verification
234- PAN-Aadhaar linkage status
235- s.234B/234C interest exposure
236- GST registration threshold monitoring (if approaching INR 20 lakh)
237- Any high-value transactions flagged in AIS
238 
239## Positions Taken
240[List with legislation citations]
241- e.g., "Presumptive taxation under s.44ADA of the Income-tax Act, 1961 -- gross receipts INR 38,00,000 (below INR 75,00,000 threshold for digital receipts > 95%)"
242- e.g., "New tax regime elected under s.115BAC -- no Chapter VI-A deductions claimed"
243- e.g., "Export of services to USA -- zero-rated supply under s.16(1) IGST Act, LUT filed"
244- e.g., "Laptop capitalised at INR 1,20,000 -- 40% depreciation under Block III (computers), IT Act 6th Schedule" (ITR-3 only)
245 
246## Planning Notes for FY 2026-27
247- Advance tax schedule (quarterly instalments with amounts and dates)
248- GST compliance calendar (monthly GSTR-3B, quarterly GSTR-1 if QRMP)
249- 44ADA lock-in tracking (years remaining if opted in)
250- Depreciation schedule continuing into next FY (WDV)
251- Regime choice review (new vs old) based on projected income
252- Any legislative changes in Union Budget 2026 affecting self-employed
253 
254## Client Action List
255 
256### Immediate (before 31 July 2026 -- ITR filing deadline):
2571. Review this return package with your Chartered Accountant
2582. Pay self-assessment tax of INR X via Challan 280 (if balance due)
2593. File ITR on incometax.gov.in
2604. E-verify ITR within 30 days of filing (Aadhaar OTP / net banking / DSC)
261 
262### If tax audit required (s.44AB -- turnover > INR 1 crore, or profit < presumptive threshold):
2631. Tax audit report in Form 3CB-3CD due by 30 September 2026
2642. ITR filing deadline extends to 31 October 2026
265 
266### Advance tax for FY 2026-27:
2671. 15 June 2026: 1st instalment -- 15% of estimated tax = INR X
2682. 15 September 2026: 2nd instalment -- cumulative 45% = INR X
2693. 15 December 2026: 3rd instalment -- cumulative 75% = INR X
2704. 15 March 2027: 4th instalment -- cumulative 100% = INR X
271(If 44ADA: can pay 100% by 15 March 2027 in single instalment)
272 
273### GST filing calendar:
274- GSTR-3B: 20th of following month (or quarterly if QRMP scheme)
275- GSTR-1: 11th of following month (or quarterly if QRMP)
276- GSTR-9 (annual): 31 December 2027
277 
278### Ongoing:
2791. Issue GST-compliant tax invoices for all taxable supplies
2802. Maintain books of account (if ITR-3) or preserve records (if 44ADA)
2813. File GSTR-3B and GSTR-1 monthly/quarterly
2824. Pay advance tax on quarterly due dates
2835. Collect and file Form 16A (TDS certificates) from clients
2846. Monitor aggregate turnover for GST registration threshold
2857. Retain all invoices and financial records for 6 years (IT Act) / 6 years (GST Act)
286```
287 
288---
289 
290## Section 5 -- Refusals
291 
292**R-IN-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.
293 
294**R-IN-2 -- Upstream self-check failed.** Name the specific check and note it in the reviewer brief. Continue.
295 
296**R-IN-3 -- Cross-skill reconciliation failed.** Name the specific reconciliation and describe the discrepancy. Flag for reviewer but continue.
297 
298**R-IN-4 -- Intake incomplete.** Specific missing intake items prevent computation. List what is missing and ask the user for the specific data point.
299 
300**R-IN-5 -- Out-of-scope item discovered during assembly.** E.g., capital gains requiring Schedule CG, rental income requiring Schedule HP, foreign assets requiring Schedule FA, or partnership income. Flag and exclude from computation.
301 
302---
303 
304## Section 6 -- Self-checks
305 
306**Check IN-A1 -- All upstream skills executed.** india-gst, in-income-tax, in-advance-tax all produced output. in-tds-freelance produced output or was computed from Form 26AS data.
307 
308**Check IN-A2 -- GST turnover matches ITR gross receipts.** Within INR 100 tolerance.
309 
310**Check IN-A3 -- If 44ADA: 50% deemed profit, no expense deductions claimed.** Deemed profit = exactly 50% of gross receipts (or higher if voluntarily declared higher).
311 
312**Check IN-A4 -- Advance tax + TDS reconciled against final liability.** Total credits (advance tax + TDS + self-assessment tax) match the payment/refund position.
313 
314**Check IN-A5 -- s.234B interest computed correctly.** If advance tax paid < 90% of assessed tax, 1% simple interest per month from April AY to date of payment/assessment.
315 
316**Check IN-A6 -- s.234C interest computed correctly.** Quarterly shortfall interest at 1% for 3 months per deficient quarter.
317 
318**Check IN-A7 -- Form 26AS TDS matches ITR.** Every TDS entry in 26AS has corresponding income in ITR. Credits claimed match 26AS amounts.
319 
320**Check IN-A8 -- Tax regime correctly applied.** New regime: s.115BAC rates, no Ch VI-A deductions (except NPS 80CCD(2)). Old regime: regular slab rates, all deductions claimed.
321 
322**Check IN-A9 -- s.87A rebate applied if eligible.** New regime: if total income <= INR 12,00,000 (after standard deduction), rebate up to INR 25,000.
323 
324**Check IN-A10 -- Surcharge and cess correctly computed.** Surcharge applicable if total income > INR 50 lakh (10%/15%/25% tiers). Cess = 4% on tax + surcharge.
325 
326**Check IN-A11 -- Filing calendar is complete.** All deadlines for ITR, GST, advance tax, and TDS are listed with specific dates and amounts.
327 
328**Check IN-A12 -- Reviewer brief contains legislation citations.** Every position taken references the specific section of the Income-tax Act 1961, CGST Act 2017, or relevant rule.
329 
330---
331 
332## Section 7 -- Output files
333 
334The final output is **three files**:
335 
3361. **`[client_slug]_2025-26_india_master.xlsx`** -- Single master workbook containing every worksheet and computation. Sheets include: Cover, GST Reconciliation (GSTR-3B vs books), ITR Computation (ITR-3 or ITR-4), Depreciation Schedule (if ITR-3), Advance Tax Reconciliation, TDS Credit Reconciliation, s.234B/234C Interest, Cross-Check Summary. Use live formulas where possible -- e.g., ITR gross receipts cell references the GST turnover cell; advance tax shortfall references the ITR final liability. Verify no `#REF!` errors. Verify computed values match within INR 1 before shipping.
337 
3382. **`reviewer_brief.md`** -- Single markdown file covering all sections from Section 4 above: executive summary, GST returns, ITR, advance tax, TDS, cross-skill reconciliation, flags, positions, planning notes.
339 
3403. **`client_action_list.md`** -- Single markdown file with step-by-step actions: immediate filings and payments, advance tax quarterly calendar for FY 2026-27, GST filing calendar, ongoing compliance reminders.
341 
342**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.
343 
344**All files are placed in `/mnt/user-data/outputs/` and presented to the user via the `present_files` tool at the end.**
345 
346---
347 
348## Section 8 -- Cross-skill references
349 
350**Inputs:**
351- `in-freelance-intake` -- structured intake package (JSON)
352- `india-gst` -- GSTR-3B/GSTR-1 reconciliation output
353- `in-income-tax` -- ITR-3/ITR-4 computation output
354- `in-advance-tax` -- Advance tax reconciliation and interest output
355- `in-tds-freelance` -- TDS credit reconciliation output (or fallback computation from Form 26AS)
356 
357**Outputs:** The final reviewer package. No downstream skill.
358 
359---
360 
361## Section 9 -- Known gaps
362 
3631. PDF form filling is not automated. The reviewer uses the worksheets to fill official ITR forms on incometax.gov.in.
3642. E-filing is handled by the reviewer via the income tax portal, not by this skill.
3653. Payment execution is the client's responsibility; the skill only provides instructions and amounts.
3664. Tax audit (Form 3CB-3CD) preparation is not automated -- if audit is required, the skill flags it and the CA prepares the audit report separately.
3675. in-tds-freelance is a Q4 stub. Until it is fleshed out, TDS reconciliation is computed using Form 26AS data from intake. This is a redundancy, not a gap -- the data source (Form 26AS) is the same.
3686. Multi-year depreciation tracking assumes the prior year schedule is provided. If not, only current-year acquisitions are depreciated.
3697. Capital gains computation (Schedule CG) is out of scope.
3708. Foreign assets reporting (Schedule FA) is out of scope.
3719. Rental income (Schedule HP) is out of scope beyond noting it as other income.
37210. The package is complete only for FY 2025-26; FY 2026-27 appears only as prospective planning.
37311. State-level professional tax varies by state and is treated as a known deduction from intake, not independently computed.
374 
375### Change log
376- **v0.1 (April 2026):** Initial draft. Modelled on mt-return-assembly v0.1 adapted for India jurisdiction with four content skills (GST, ITR, advance tax, TDS).
377 
378## End of skill
379 
380 
381---
382 
383## Disclaimer
384 
385This 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 Chartered Accountant, tax practitioner, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon.
386 
387The 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.
388 

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.

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/33

About

Final orchestrator skill that assembles the complete India filing package for India-resident self-employed individuals and professionals. Consumes outputs from all India content skills (india-gst for GSTR-3B/GSTR-1, in-income-tax for ITR-3/ITR-4, in-advance-tax for quarterly instalments, in-tds-freelance for TDS reporting) 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 India content skills listed above. India full-year residents only. Self-employed individuals and professionals only.

INty-2025

3 of 5 in the IN workflow: