# Bhatt & Joshi Associates — Website Forward-Work Roadmap **Author:** Bhatt & Joshi Associates (orchestrator) · **Date:** 31 May 2026 · **Status:** Live working document This roadmap defines the agentic architecture by which the firm's website is upgraded over successive sessions. The user presses "next"; the orchestrator dispatches one or more workstreams in parallel; deliverables land in the website folder; the roadmap is updated. --- ## 1. The end state A self-contained, vendor-neutral, Vercel-deployable Bhatt & Joshi Associates GIFT-IFSC portal with: - **20 head pages** (existing) — each carrying its IFSCA-codified interactive tool and at least one practitioner booklet - **30+ booklets** in the library (current 11 + ~19 new across 16 unserved heads + cross-cutting) - **Resources page** — every Act, Regulation, Master Circular, Notification, Press Note keyed to the head(s) it serves; deep links to authoritative gazettes / IFSCA / RBI / IRDAI / DPIIT - **Insights page** — periodic updates as the regulatory landscape evolves - **Tools page** — investor tools (FME selector; tax-holiday calculator; head-finder) - **Coherent brand identity** — real B&J logo (square monogram + horizontal wordmark) and harmonised navy `#003A8C` colour across the website and every booklet cover ## 2. The agentic architecture Five parallel agent roles run across the project. In any one session, the orchestrator (Claude) dispatches as many agents as the context budget allows. | Role | What the agent does | Typical tools | |---|---|---| | **A · Research agents** | Pull verbatim text of statutes, regulations, master circulars; identify chapters; map precedents | WebSearch, WebFetch | | **B · Writer agents** | Take a research brief and produce a finished docx booklet under the firm's branding template | python-docx + bnj_branding | | **C · Designer agents** | Build SVG diagrams, harmonise covers, render images for embedding | cairosvg, python-docx | | **D · Integrator agents** | Edit HTML pages — update booklets.html, resources.html, head pages with new content; preserve existing JS / CSS | sed/python-edit | | **E · Auditor agents** | Sweep each page for stale facts, broken links, regulatory updates, accessibility | Read, Grep | Within each session the orchestrator typically runs A and B in parallel for a target booklet, then D to integrate the result. E runs on a slower cadence (every third session). ## 3. The integration cycle (one booklet per cycle) 1. **Brief.** Orchestrator drafts a research prompt for Agent A, naming the head and scope. Brief always includes a request for an **interactive-tool specification** appropriate to the head (eligibility checklist, selector, or calculator). 2. **Research.** Agent A returns verbatim quotes + URLs + 6-8 chapter outline + a paste-ready HTML/JS interactive tool spec (under 1,800 words). 3. **Write.** Agent B (or the orchestrator directly) produces the booklet docx under `_Brand Assets/Build Scripts/`. 4. **Convert.** docx → PDF via LibreOffice headless. 5. **Brand.** Apply the appropriate cover (dark for practitioner booklets, light for research/publication) using the real-logo cover pipeline. 6. **Place.** PDF copied to `Website/booklets-pdf//`. 7. **Integrate booklet.** `booklets.html` updated with a new card linking to the PDF; previous "NEW" tag removed; new booklet flagged "NEW". 7a. **Deploy interactive tool.** Build or update the dedicated head page (`ifsc-.html`) embedding the interactive tool from the research brief. Tool uses vanilla JS + the site's CSS variables — no dependencies. Tool stamped "Indicative only — not legal advice." Link to the booklet PDF added as Related Reading. Card on `booklets.html` includes a "Try the live →" link to the head page. 8. **Resources update.** Any primary-source citation in the new booklet that isn't already on `resources.html` is added under the relevant head section. 9. **Audit.** Quick verification: PDF opens, link works, tool runs in a browser, no broken refs. 10. **Log.** Roadmap section 6 (Backlog) and section 10 (This Session) updated; backlog item moved to ☑ shipped. ## 4. Gate model Each booklet goes through three gates before being declared "shipped": - **Gate 1 — Research complete.** Agent A's brief reviewed; verbatim quotes present. - **Gate 2 — Draft built.** Booklet docx exists with cover, 6-8 chapters, no syntax errors. - **Gate 3 — Integrated.** PDF in website folder; booklets.html updated; resources.html updated where needed; tested locally. The user may sign off at any gate by saying so explicitly. Default is: all three gates fire automatically and the orchestrator reports completion. ## 5. Brand discipline - Logo: `_Brand Assets/Logos/bnj_logo.png` (square 200×200) and `bnj_wordmark.png` (horizontal 741×414) are the canonical files. Both are the real B&J marks extracted from the website's `index.html`. - Cover colour: `#003A8C` (sampled from the real logo's background). The earlier `#0B2545` is deprecated for new work — existing booklet covers will be re-harmonised in a sweep agent run. - Sub-brand strap: "A BHATT & JOSHI PUBLICATION" (long-form monographs) / "A BHATT & JOSHI PRACTITIONER HANDBOOK" (short-form handbooks) / "A BHATT & JOSHI RESEARCH MONOGRAPH" (formal research). - The private legal opinion to INGOSSTRAKH (Research Vol III) does **not** ship to the website. ## 6. Backlog — booklets to write Booklets are written one head per cycle (sometimes two if the heads are short). Status flags: ☐ not started · ◐ in progress · ☑ shipped. | # | Head | Booklet number | Title | Status | |---|------|----------------|-------|--------| | 1 | Banking (IBUs) | VIII | Setting Up an IFSC Banking Unit at GIFT City | ☑ shipped 31 May 2026 — 9 pp PDF in `booklets-pdf/01_banking_ibus/` | | 2 | Global Administrative Office | IX | The Global Administrative Office at GIFT City | ☑ shipped 31 May 2026 — 8 pp PDF in `booklets-pdf/02_global_administrative_office/`; live tool at `/ifsc-gao.html` (GAO Eligibility Checker) | | 3 | Finance Company / Treasury | X | Finance Companies and Treasury Centres at GIFT IFSC | ☑ shipped 31 May 2026 — 7 pp PDF in `booklets-pdf/03_finance_company_treasury/`; live FC Category Selector at `/ifsc-finance-company.html` | | 4 | Global In-House Centre | XI | The Global In-House Centre Pathway | ☑ shipped 31 May 2026 — 9 pp PDF in `booklets-pdf/04_global_in_house_centre/`; live GIC Operating-Model Selector at `/ifsc-gic.html` | | 5 | Capital Market Intermediaries | XII | Capital Market Intermediaries at GIFT IFSC | ☑ shipped 31 May 2026 — 10 pp PDF in `booklets-pdf/05_capital_market_intermediaries/`; live CMI Net-Worth Calculator at `/ifsc-capital-market-intermediaries.html` | | 6 | FinTech | XIII | The FinTech Pathway at GIFT IFSC | ☑ shipped 31 May 2026 — 13 pp PDF in `booklets-pdf/06_fintech/`; live FinTech Pathway Selector at `/ifsc-fintech-entity.html` | | 7 | Aircraft Leasing | XIV | Aircraft Leasing from GIFT City | ☑ shipped 31 May 2026 — 16 pp PDF in `booklets-pdf/08_aircraft_leasing/`; live Aircraft Lease Structuring Wizard at `/ifsc-aircraft-leasing.html` | | 8 | Bullion Exchange | XV | The IFSC Bullion Exchange and Vault Ecosystem | ☑ shipped 31 May 2026 — 12 pp PDF in `booklets-pdf/10_bullion_exchange/`; live Bullion Pathway Selector at `/ifsc-bullion-exchange.html` | | 9 | Ship Leasing | XVI | Ship Leasing from GIFT IFSC | ☑ shipped 31 May 2026 — 15 pp PDF in `booklets-pdf/11_ship_leasing/`; live Ship Lease Structuring Wizard at `/ifsc-ship-leasing.html` | | 10 | Ancillary Services | XVII | Ancillary Services at IFSC | ☑ shipped 31 May 2026 — 15 pp PDF in `booklets-pdf/12_ancillary_services/`; live Ancillary Service Pathway Selector at `/ifsc-ancillary-services.html` | | 11 | Foreign Universities | XVIII | Foreign Universities at GIFT IFSC | ☑ shipped 31 May 2026 — 12 pp PDF in `booklets-pdf/13_foreign_universities/`; live IBC/OEC Eligibility & Pathway Checker at `/ifsc-foreign-universities.html` | | 12 | Capital Markets / MIIs | XIX | Market Infrastructure Institutions at GIFT IFSC | ☑ shipped 31 May 2026 — 15 pp PDF in `booklets-pdf/14_capital_markets_miis/`; live MII Eligibility & Comparison Tool at `/ifsc-capital-markets-mii.html` | | 13 | Payment Services | XX | Payment Service Providers at GIFT IFSC | ☑ shipped 31 May 2026 — 15 pp PDF in `booklets-pdf/15_payment_services/`; live PSP Category Selector at `/ifsc-payment-services.html` | | 14 | Factoring & Forfaiting (ITFS) | XXI | International Trade Financing Services Platform | ☑ shipped 31 May 2026 — 14 pp PDF in `booklets-pdf/16_factoring_forfaiting_itfs/`; live ITFS Participant Pathway Selector at `/ifsc-factoring-forfaiting-itfs.html` | | 15 | BATF Services | XXII | BATF Services at GIFT IFSC | ☑ shipped 31 May 2026 — 17 pp PDF in `booklets-pdf/17_batf_services/`; head page already had live BATF Service Scope & Materiality Selector — booklet now linked from head page Related Reading | | 16 | Listing & Capital Raising | XXIII | IPO and Listing at IFSC Stock Exchanges | ☑ shipped 31 May 2026 — 17 pp PDF in `booklets-pdf/18_listing_capital_raising/`; live Issuer Listing Pathway Tool deployed on /ifsc-listing-capital-raising.html (head page upgraded from text-only to full content + tool) | | 17 | Credit Rating Agencies | XXIV | Credit Rating Agencies at GIFT IFSC | ☑ shipped 31 May 2026 — 15 pp PDF in `booklets-pdf/19_credit_rating_agencies/`; live CRA Authorisation & Coverage Tool at `/ifsc-credit-rating-agencies.html` | | 18 | Cross-cutting | XXV | The Master Catalogue — All 20 IFSC Business Heads | ☑ shipped 31 May 2026 — 17 pp PDF in `booklets-pdf/xx_master_catalogue/`; cross-cutting reference deliverable consolidating all 20 heads + tax architecture + AML perimeter | | 19 | Cross-cutting (investor) | XXVI | The Investor's Guide to GIFT IFSC | ☑ shipped 31 May 2026 — 14 pp PDF in `booklets-pdf/xx_investor_guide/`; final entry in the 26-volume Practitioner Series; outward-facing complement to the licensing handbooks | ## 7. Backlog — page upgrades | Page | Current | Upgrade target | |------|---------|----------------| | `index.html` | Hero + safe-harbour band + headline cards | Add latest-booklet ribbon; testimonials carousel; press-mentions strip | | `gift-city.html` | 20-head search + filter | Filter chips persist via querystring; "Compare two heads" mode | | `tools.html` | ☑ Tax-holiday estimator + Head-finder live (31 May 2026) | Add Reg 5(9) IIO eligibility quiz; ECB MAMP / cost calculator; Section 147 lifetime estimator | | `booklets.html` | ☑ 14-booklet shelf with download links + NEW tag rotation | Filter-by-head chips; "what's new" ribbon | | `insights.html` | ☑ Populated with 10 verified items (31 May 2026) | Convert each Insight to its own article HTML; chronological feed; RSS | | `resources.html` | ☑ Live with primary sources grouped by head (31 May 2026) | Add search; add citation-RIS export | | `about.html` / `practice.html` | ☑ Live (31 May 2026) | Add partner bios; track record; news mentions | | Each `ifsc-*.html` head page | ☑ 17 head pages now exist (4 with live interactive tools, 13 with "in production" booklet announcements) | Build interactive tool per head as each Booklet ships; add Related Reading panel | | `contact.html` | Form + map | Form submission JS; meeting-time picker; case-type tagging | ### Site coverage as at 31 May 2026 | Status | Count | Pages | |---|---|---| | Live with full content + interactive tool | 19 | ifsc-gao, ifsc-finance-company, ifsc-gic, ifsc-batf-services, ifsc-capital-market-intermediaries, ifsc-fintech-entity, ifsc-aircraft-leasing, ifsc-bullion-exchange, ifsc-ship-leasing, ifsc-ancillary-services, ifsc-foreign-universities, ifsc-capital-markets-mii, ifsc-payment-services, ifsc-factoring-forfaiting-itfs, ifsc-credit-rating-agencies, ifsc-listing-capital-raising, ifsc-ifsc-banking-units, ifsc-insurance-iio, ifsc-fund-management-entity | | Live with full content (no interactive tool yet) | 0 | (all 19 operational head pages now have full content + interactive tool as of 31 May 2026) | | Live with "Booklet in production" announcement | 0 | (all booklet placeholders cleared as of 31 May 2026 — site has zero placeholders remaining) | | Cross-cutting | 8 | index, gift-city, tools, booklets, insights, resources, about, practice, contact, ifsc-tax-regime, ifsc-global-administrative-office (alias), ifsc-global-in-house-centre | | **Total pages** | **31** | (zero broken internal links as at 31 May 2026) | ## 8. The next-session protocol When the user presses "next", the orchestrator does — in this order: 1. Pick the **earliest ☐** booklet in section 6 backlog. 2. Dispatch a research agent (Role A). 3. Once the research returns, write the booklet (Role B). 4. Convert to PDF, brand the cover, place in website folder, update `booklets.html` and `resources.html`. 5. If context budget permits, immediately repeat the cycle for the next backlog item (run two writers in parallel where possible). 6. Update this Roadmap (section 6 + section 7) to reflect what was shipped. 7. Report results to the user with file links. If the user wants a different priority order, they can name the booklet or page and the orchestrator will reorder. ## 9. Audit cadence Every fifth session, the orchestrator dispatches Auditor agents (Role E) to: - Walk every HTML page and flag broken links, outdated dates, stale regulatory references. - Cross-check every booklet PDF for 200 OK status when linked from `booklets.html`. - Sample three booklet covers and confirm consistent brand identity. - Produce an `AUDIT_LOG.md` entry with findings. ## 10. What ships in **this** session - ☑ Roadmap document (this file). - ☑ Booklet VIII research brief (Agent A returned 1,800-word brief with verbatim quotes). - ◐ Booklet VIII docx + PDF (Agent B writing — in progress this session). - ◐ Updated `booklets.html` with real download links to the 11 existing booklets. - ◐ `resources.html` first draft — Acts, Regulations, Master Circulars listed by head. - ◐ Colour-harmonisation patch: `NAVY = '#003A8C'` propagated to the dark-cover and light-cover builders for any future re-issue. Whatever does not finish this session is queued at the top of next session's backlog. The user presses "next" and the orchestrator resumes.