israeli-bureaucracy-decoder

name	israeli-bureaucracy-decoder
description	Decode confusing Israeli government letters, forms, and official documents into plain language. Use when you receive mail from the Tax Authority, Bituach Leumi, municipalities, Interior Ministry, Land Registry, courts, or any government body and need to understand what it says, what action is required, and by when. Covers assessment notices, benefit decisions, municipal levies, zoning notices, and court summons. Do NOT use for drafting legal appeals or providing binding legal advice.
license	MIT
allowed-tools	Bash(python:*) Read Edit WebFetch
compatibility	Works with all major AI coding agents

Israeli Bureaucracy Decoder

Think of this skill as your friend who works in the government. You hand them a confusing letter, they read it, and tell you: "Relax, here is what this actually means, and here is what you need to do."

Instructions

Step 1: Receive the document

Ask the user to paste the full text of the government document, or provide a file path to a scanned/digital document. Accept text in Hebrew, English, or a mix of both (common in official Israeli documents).

If the user provides a file path, read the file content. If it is a text file, read it directly. If the user describes the document rather than pasting it, ask clarifying questions to identify the sending body and document type.

Step 1.5: Check the user's personal area (ezor ishi / MyGov) first

Before escalating to phone calls or office visits, ask the user whether they have already signed into the relevant personal area. Many "missing" letters are actually sitting in the user's digital inbox. The common personal-area accounts are:

• Tax Authority: misim.gov.il
• Bituach Leumi: btl.gov.il ("אזור אישי")
• Population and Immigration Authority (PIBA): piba.gov.il
• Unified gov.il sign-in: gov.il/he/service/digital-identification

If a digital copy of the letter is available there, work from that copy. It is usually clearer, dated more reliably, and links to the underlying file. This is especially relevant if the paper letter is illegible, cut off, or arrived late.

Step 2: Identify the sending body and document type

Consult references/government-bodies-guide.md to identify which government body sent the document. Look for:

• Letterhead or header text (e.g., "רשות המסים בישראל", "המוסד לביטוח לאומי")
• Reference numbers and their formats (each body uses different patterns)
• Official stamps, department names, or regional office identifiers
• Form numbers (e.g., "טופס 101", "טופס 1301")

Cross-reference any form numbers with references/common-government-forms.md to understand the form's purpose.

Step 3: Decode the bureaucratic language

Consult references/bureaucratic-hebrew-glossary.md to translate official jargon into plain language. Government documents are deliberately written in dense legal Hebrew. Your job is to cut through that.

For each paragraph or section of the document:

1. Identify the key information being communicated
2. Replace bureaucratic terms with everyday language
3. Note any legal references (laws, regulations, clauses) and explain what they mean in practice
4. Flag anything that sounds threatening but is actually standard boilerplate

Step 4: Run the document analyzer

Use the document analyzer script to extract structured information:

python scripts/document-analyzer.py --text "PASTE_DOCUMENT_TEXT_HERE"

Or if the text is in a file:

python scripts/document-analyzer.py --file path/to/document.txt

The script extracts: sender, document type, subject, required actions, deadlines, consequences of inaction, and relevant laws.

Step 5: Present the decoded summary

Before you write the summary, check kol-zchut. Before calling the office or quoting a benefit amount, look up the relevant entry on kol-zchut.org.il for the canonical Hebrew explanation of the right, benefit, deadline, or appeal venue mentioned in the letter. Kol-zchut is the most reliable plain-language source for current Israeli civic rights. Prefer its numbers and deadlines over older information when they conflict, and quote it when you cite a ceiling, rate, or window.

Present the decoded document in this clear format:

Who sent this: [Government body name in plain language]

What this is: [Document type in one sentence]

What it actually says: [Plain language summary, 2-4 sentences. No jargon.]

What you need to do:

1. [Action item with specific details]
2. [Action item with specific details] (number each action clearly)

Deadlines:

• [Date] -- [What needs to happen by this date]
• [Date] -- [What happens if you miss this date]

How urgent is this?

• URGENT (red flag): if there is a deadline within 30 days, a court date, or a threat of enforcement
• IMPORTANT (yellow flag): if there is a deadline within 90 days or a required response
• INFORMATIONAL (green flag): if no action is required, just awareness

Next steps:

• [Specific guidance: which office to contact, which form to fill, phone numbers if known]
• [Whether you should consult a professional (accountant, lawyer, social worker)]

Step 6: Offer follow-up help

After presenting the summary, offer to:

1. Explain any specific section in more detail
2. Help draft a response letter if one is needed
3. Identify related forms that might need to be filed
4. Explain what happens if the user takes no action
5. Translate the summary into the other language (Hebrew to English or vice versa)

Decision Table: Sender + Key Term → Urgency, Window, Appeal Venue

Use this as a fast lookup when classifying urgency and pointing the user to the right escalation channel. These are typical patterns, always verify the specific deadline written on the letter itself and on the current kol-zchut entry, since regulations and ceilings shift.

Sender	Key term in the letter	Urgency tier	Standard response window	Where to appeal / escalate
Tax Authority	שומה לפי מיטב השפיטה	URGENT	30 days to file a written השגה (objection) under Section 150 of the Income Tax Ordinance	Internal השגה, then appeal to District Court (Tax Affairs)
Tax Authority	החלטה בהשגה	URGENT	30 days	District Court (Tax Affairs)
Tax Authority	הודעת קנס	URGENT	30 days to pay or appeal	Internal review, then court
Bituach Leumi	דחיית תביעה	IMPORTANT	12 months to appeal	Beit Din L'Avoda (Labor Court)
Bituach Leumi	קביעת אחוזי נכות	IMPORTANT	60 days to appeal	Medical Appeals Committee, then Beit Din L'Avoda
Municipality	שינוי סיווג ארנונה	IMPORTANT	90 days to file השגה	מנהל הארנונה, then Arnona Appeals Committee, then court
Municipality	התראה לפני נקיטת הליכים	URGENT	Act immediately	Pay, arrange installments, or contest at Magistrate Court
Planning Committee	סירוב היתר	IMPORTANT	30-45 days per the letter	District Planning Committee, then administrative petition
Planning Committee	צו הריסה	URGENT	Per the order	Magistrate Court (planning division), and counsel immediately
Hotzaa LaPoal	אזהרה	URGENT	30 days	התנגדות לביצוע at the Execution Office
Hotzaa LaPoal	עיקול	URGENT	Immediate	Motion to release / arrangement
Court	הזמנה לדין	URGENT	Per the summons	The court itself; consult a lawyer
Court (Magistrate)	כתב תביעה	URGENT	60 days to file כתב הגנה (תקנות סדר הדין האזרחי תשע"ט-2018)	The same court
Court (Small Claims)	כתב תביעה	URGENT	30 days to file כתב הגנה	The same court
PIBA	החלטה בעניין מעמד	URGENT	Per the letter (often 21-45 days)	Internal appeal in PIBA, then Administrative Affairs Court
Interior Ministry (Misrad HaPnim)	הודעה בעניין תעודת זהות	INFORMATIONAL or MEDIUM	Per the letter	Misrad HaPnim regional registration office
Mevaker HaMedina	פנייה / החלטה	INFORMATIONAL	Per the letter	Cooperate; this is itself an escalation venue

Escalation ladder when standard channels fail

When the agency's internal objection / appeal has been used (or is plainly futile):

1. Freedom of Information request (gov.il/he/service/freedom_of_information_submission) if the letter cites information the user cannot otherwise access. Each public body has a designated information officer; statutory response window 30 days, which the head of the body may extend by an additional 30 days (and further for voluminous or complex requests). A request fee of 24 NIS applies (as of late 2025, covering the first 3 hours of processing), plus per-hour and per-page handling charges, with exemptions per the 1998 law.
2. State Comptroller and Ombudsman (complaint intake at complaint.mevaker.gov.il) for complaints about maladministration, delay, or abuse of authority by a public body. In Israel the State Comptroller and the Ombudsman (נציב תלונות הציבור) are the same office.
3. Administrative petition (עתירה מנהלית) to the District Court sitting as an Administrative Affairs Court, with strict time limits (typically 45 days from the decision). For nationwide-impact or constitutional issues, the High Court of Justice (בג"ץ). Always recommend consulting a lawyer first.

Examples

Example 1: Tax Authority Assessment Notice

User says: "I got this letter from Reshut HaMisim and I have no idea what it means. It says something about shomah and I need to respond within 30 days?"

Actions:

1. Read the document text the user provides
2. Identify it as a "שומה" (tax assessment) from the Tax Authority, likely a "שומה לפי מיטב השפיטה" (best judgment assessment) or "שומה בהסכמה" (agreed assessment)
3. Consult the government bodies guide to understand Tax Authority assessment types
4. Consult the glossary for terms like "שומה", "השגה", "מס הכנסה", "סעיף 150"
5. Run the document analyzer to extract deadlines and required actions
6. Present a clear summary explaining that a "shomah" is essentially the Tax Authority's calculation of how much tax they think the user owes, and whether the user agrees or wants to dispute it

Result: The user understands they received a tax assessment notice. The decoder explains that "שומה לפי מיטב השפיטה" means the Tax Authority made their own calculation because the user either did not file a return or the Authority disagrees with what was filed. The user has 30 days to file a "השגה" (objection) if they disagree, or the assessment becomes final. The decoder suggests consulting a tax accountant ("רואה חשבון") before the deadline.

Example 2: Bituach Leumi Benefit Decision

User says: "Bituach Leumi sent me a letter about my miluim claim. There are a lot of numbers and references to sections of the law. Can you tell me if they approved it?"

Actions:

1. Read the document text
2. Identify it as a decision letter from the National Insurance Institute regarding reserve duty ("מילואים") compensation
3. Consult the glossary for terms like "תגמול", "דמי מילואים", "חוק הביטוח הלאומי"
4. Look for key phrases: "אושרה" (approved), "נדחתה" (denied), "חלקית" (partial)
5. Extract the payment amount, period covered, and payment date
6. Present a clear breakdown of the decision

Result: The user learns their reserve duty claim was approved for 15 days at the minimum daily rate of 328.76 NIS (the floor effective 01.01.2026; the actual rate is usually higher and based on the reservist's income), totaling 4,931.40 NIS before tax. Payment will arrive within 10 business days. The letter references Section 272 of the National Insurance Law, which is the standard legal basis for the reserve duty compensation rate (within Chapter XII, "תגמולים למשרתים במילואים"), nothing unusual. No action required unless the user believes the number of days or the daily rate is incorrect, in which case they have 12 months to appeal.

Example 3: Municipal Arnona Notice

User says: "My iriya sent something about arnona and it mentions hanacha but I can not tell if they are giving me a discount or asking for more money."

Actions:

1. Read the document text
2. Identify it as a municipal tax ("ארנונה") notice, likely about a discount ("הנחה") decision
3. Consult the glossary for "ארנונה", "הנחה", "ועדת הנחות", "סיווג נכס"
4. Look for whether the document is: an approval of a discount, a rejection, a reclassification of the property, or an annual rate update
5. Check for any payment schedule or deadline information
6. Present a clear explanation of the arnona system and what this specific notice means

Result: The user's municipality approved a 25% arnona discount based on income level ("הנחה לפי מבחן הכנסות"). The discount applies from January to December of the current year. The remaining balance is 8,400 NIS, payable in 6 bi-monthly installments. No action needed unless the user's income has changed significantly, in which case they can request a reassessment. The decoder also notes that the discount does not renew automatically and the user will need to reapply next year with updated income documentation.

Example 4: Court Summons or Legal Notice

User says: "I got something from Beit Mishpat that looks serious. It has a date and a case number. Am I being sued?"

Actions:

1. Read the document text carefully
2. Identify the court type (Magistrate/שלום, District/מחוזי, Small Claims/תביעות קטנות, Family/משפחה, Labor/עבודה)
3. Determine the document type: summons ("הזמנה לדין"), claim ("כתב תביעה"), judgment ("פסק דין"), or notification ("הודעה")
4. Extract the case number, parties involved, hearing date, and required response
5. Flag this as URGENT and recommend immediate professional consultation

Result: The user received a summons to Small Claims Court as the defendant. Someone filed a claim against them for 12,000 NIS regarding a service dispute. The hearing is scheduled for 45 days from the letter date. The user MUST file a written defense ("כתב הגנה") within 30 days of receiving the claim, or they risk a default judgment ("פסק דין בהיעדר הגנה"). The decoder strongly recommends consulting a lawyer, though representation by a lawyer is not required in Small Claims Court.

Bundled Resources

Scripts

• scripts/document-analyzer.py -- Analyze government document text to extract structured information (sender, type, actions, deadlines, consequences). Run: python scripts/document-analyzer.py --help

References

• references/government-bodies-guide.md -- Comprehensive guide to Israeli government bodies, their common letter types, typical jargon, and what they usually want from you. Consult when identifying which body sent a document and what type of document it is.
• references/bureaucratic-hebrew-glossary.md -- Hebrew bureaucratic terms with plain-language explanations, organized by domain (legal, tax, social security, municipal, real estate, immigration). Consult when you encounter official jargon that needs translation to everyday language.
• references/common-government-forms.md -- Index of frequently encountered Israeli government forms with their purposes, who needs to file them, and when. Consult when a document references a form number or when advising the user on which forms to file.

Recommended MCP Servers

MCP	What It Adds
Kolzchut (All-Rights)	Look up actual rights and entitlements referenced in government letters. When a document mentions a benefit, discount, or eligibility, Kolzchut provides the authoritative details.
Israel Law	Query specific law sections cited in documents. When a letter references "Section 150 of the Income Tax Ordinance," this MCP can retrieve the actual text.
Knesset	Access legislative data for bills and committee information. Useful when documents reference pending legislation or regulatory changes.

Gotchas

• Israeli government form names change over time, and the same form may have different names in different offices. Agents may reference a form name that is no longer current.
• Hebrew bureaucratic language (lashon misradit) uses formal/archaic terms that differ from everyday Hebrew. Agents may generate translations using everyday Hebrew that do not match the official terminology on forms.
• Many Israeli government processes require in-person visits (biu'ach ishi) and cannot be completed entirely online. Agents may suggest completing a process online when a physical visit is required.
• Government office hours in Israel vary: some close at 12:30 PM on certain days, and most are closed on Fridays. Agents may suggest visiting offices during hours when they are closed.
• gov.il URLs are frequently restructured and individual department slugs redirect or 404. Treat direct deep links as best-effort, not authoritative. If a slug does not resolve, send the user to the gov.il homepage and have them search by the service name (the search bar is more stable than department paths).
• In-person visits almost always require a pre-booked appointment now. The unified gov.il booking portal is govisit.gov.il (users may know it by the myVisit mobile-app brand from the same vendor). Agency-specific portals: PIBA (piba.gov.il), Bituach Leumi (btl.gov.il).
• Many digital forms now require a personal digital signature certificate from a licensed certification authority (גורם מאשר) such as comsign or PersonalID, both real Israeli providers regulated under the Electronic Signature Law, 5761-2001. Suggesting "just sign it digitally" without checking is wrong if the user does not have a certificate set up; the authoritative reference and the registry of accredited certification authorities live on the Ministry of Justice electronic-signature page (justice.gov.il/Units/YeutzVehakika/NosimMishpatim/Pages/HatimaElectronit.aspx).

Reference Links

Source	URL	What to Check
Israel Tax Authority	https://www.gov.il/en/departments/israel_tax_authority	Tax assessment types, objection procedures, current deadlines
Bituach Leumi (NII)	https://www.btl.gov.il	Benefit amounts, claim forms, eligibility criteria
Knesset Legislation Database	https://main.knesset.gov.il/Activity/Legislation	Full text of laws cited in government documents
Kolzchut (All-Rights)	https://www.kolzchut.org.il	Plain-language explanations of rights and entitlements
Israeli Courts	https://www.gov.il/en/departments/the_judicial_authority	Court procedures, filing deadlines, small claims limits
Enforcement Authority	https://www.gov.il/en/departments/enforcement_and_collection_authority	Execution file procedures, objection deadlines

Troubleshooting

Error: "I cannot identify which government body sent this"

Cause: The document may be missing a clear letterhead, or it may be from a lesser-known sub-department or regional office. Some documents come from private entities acting on behalf of government bodies (e.g., collection agencies hired by municipalities).

Solution: Look for these secondary identifiers: (1) Reference number format, as each body uses distinct patterns. (2) The legal clauses cited in the document, which point to specific laws administered by specific bodies. (3) The return address or phone number. (4) Any form numbers mentioned. If still unclear, ask the user if they have the envelope, which may have additional identifying information. Consult references/government-bodies-guide.md for reference number patterns.

Error: "The document references a law or regulation I do not recognize"

Cause: Israeli bureaucratic documents frequently cite specific sections of laws ("סעיף 150 לפקודת מס הכנסה") without explaining what those sections say. There are hundreds of laws and thousands of sections.

Solution: Note the law name and section number, then explain the general domain it covers based on context. Common laws you will encounter: Income Tax Ordinance ("פקודת מס הכנסה"), National Insurance Law ("חוק הביטוח הלאומי"), VAT Law ("חוק מס ערך מוסף"), Planning and Building Law ("חוק התכנון והבנייה"), Municipal Ordinances ("צווי ארנונה"). If the specific section is critical to understanding the document, use WebFetch to look up the section text on the Knesset legislation database (main.knesset.gov.il) or on Israeli legal databases.

Error: "The deadline has already passed"

Cause: Government letters in Israel are sent by regular mail, and delivery can take 5-14 days. By the time the user reads the letter, a significant portion of the response window may have elapsed. Some letters have a "deemed received" date that is several days after the actual send date.

Solution: First, check if the deadline is calculated from the send date or the receipt date (look for "מיום המשלוח" vs "מיום הקבלה"). Many deadlines in Israeli law are calculated from the "deemed receipt" date, which is typically 3-5 days after the send date. If the deadline has truly passed, explain the consequences and advise the user on options: (1) Some bodies allow late submissions with a reasonable explanation. (2) Courts and the Tax Authority have formal extension request procedures. (3) In some cases, the deadline is not absolute and the user can still act, just with reduced leverage. Recommend consulting a professional immediately.

Error: "The document is partially illegible or cut off"

Cause: Scanned documents, old faxes, or photocopied letters may have missing sections, blurred text, or cut-off margins. Government offices sometimes print on both sides, and the user may have only scanned one side.

Solution: Work with what is available. Identify as many structural elements as possible (sender, reference number, date, any visible deadlines). Flag the missing sections explicitly in the summary and note what information might be in the illegible parts. Suggest the user: (1) Check if there is a second page or reverse side. (2) Contact the sending body's call center with the reference number to get the document resent or read over the phone. (3) Check their government portal account (e.g., the Tax Authority's "Personal Area" at misim.gov.il) where many documents are available digitally.