nice to have
Back to the shelf Sign in Submit a kit
← All kits

Employment Notice Kit

Just talk, and get an employment notice checked against minimum wage

How to use
Example output from Employment Notice Kit

Employment Notice Kit is a vibe coding kit for Claude Code and Codex. Just talk, and get an employment notice checked against minimum wage. It includes 7 fixes for pitfalls the maker hit in real work. Free.

When this helps

You need to issue employment notices, but requirements change often, so old templates miss new rules

What it does

Tell it the name, employment type, start date, workplace and duties, hours and pay, and it drafts an employment notice. Before issuing, it checks the scope of possible changes to workplace and duties, the cap on fixed-term renewals, conversion to indefinite term after 5 years, part-time/fixed-term items such as raises, retirement allowance, a contact point and the complaint-handling contact for treatment differences, and whether pay meets the minimum wage that rises each autumn by prefecture. Items to fix are marked ✗ and items to confirm are marked △. It outputs PDF and Word, keeping prior versions when you issue a renewal or raise. It can also check an existing notice template for gaps, and a ledger tracks every contract's end date, conversion to indefinite term, and minimum-wage shortfalls across staff.

The fixes baked into this kit

  1. Old templates miss new requirementsMHLW's model form used through September 2026 is missing only the contact point for treatment-difference explanations, so it now warns on the results page when an old template is used
  2. Mistook the general form for the part-time formIt was telling forms apart by the word 'part' in the law's name (Part-Time and Fixed-Term Workers Act), so it now strips the law's name before classifying
  3. Couldn't read start/end dates as a contract termA real HR system's 'contract start date / contract end date' wasn't recognised as a contract term, so start date, end date, and employment period are now all treated as the contract term
  4. Missed the reason for dismissal fieldIt was marking dismissal reasons ✗ even though a 'retirement matters' field existed, so it now marks △ only when the wording is actually missing
  5. Missed missing hours for fixed overtime payThe fixed-overtime-pay field had no hours listed, so it now marks ✗ whenever hours aren't written
  6. PDF for a raise's second version silently failedA single-page PDF takes 7-12 seconds and the second version's PDF for a raise was silently dropped, so the wait is now extended, completion is verified, and a failure is reported on the results page
  7. Minimum wage effective dates were offMinimum wage was cross-checked against all 47 prefectures' FY2026 rates and effective dates, and checks are now split by whether the effective date has passed

What's inside

  • The flow that drafts a notice from what you tell it
  • A pre-issue check that flags gaps and minimum-wage shortfalls with ✗/△
  • A tool that finalises the notice as PDF and Word
  • A tool that checks an existing notice template for gaps
  • A ledger watching every contract's end date, conversion to indefinite term, and minimum-wage shortfalls
  • A sample bakery company to try it with
  • A record of fixes found against MHLW's model forms and a real HR system
File list (40)
  • .gitignore
  • AGENTS.md
  • CLAUDE.md
  • KIT.md
  • NOTES.md
  • data/README.md
  • output/README.md
  • rules/CHECK.md
  • rules/FLOW.md
  • rules/LAW.md
  • rules/PROMPTS.md
  • rules/SPEC.md
  • rules/TONE.md
  • samples/midoridai-bakery/company.json
  • samples/midoridai-bakery/fix2.json
  • samples/midoridai-bakery/fix3.json
  • samples/midoridai-bakery/fix4.json
  • samples/midoridai-bakery/old-notice.txt
  • samples/midoridai-bakery/person1-fulltime.json
  • samples/midoridai-bakery/person2-parttime.json
  • samples/midoridai-bakery/person3-contract.json
  • samples/midoridai-bakery/person4-student.json
  • samples/midoridai-bakery/renewal2.json
  • tools/check.mjs
  • tools/draft.mjs
  • tools/issue.mjs
  • tools/ledger.mjs
  • tools/lib/book.mjs
  • tools/lib/docx.mjs
  • tools/lib/law.mjs
  • tools/lib/layout.mjs
  • tools/lib/ledger.mjs
  • tools/lib/notice.mjs
  • tools/lib/paths.mjs
  • tools/lib/pdf.mjs
  • tools/lib/read.mjs
  • tools/lib/render.mjs
  • tools/lib/result.mjs
  • tools/lib/run.mjs
  • tools/lib/show.mjs

The first three decisions

  1. Who it's for (name, employment type, start date)
  2. Workplace and duties (whether the scope may change)
  3. Hours and pay

What you need

  • No extra costClaude Code or CodexBoth CLAUDE.md and AGENTS.md are included
  • No extra costNode.js 18 or newerTo run the tools. Nothing else to install
  • No extra costGoogle Chrome or Microsoft EdgeFor generating PDFs (without it, use your browser's Print to PDF)
  • No extra costExcel, Numbers, or WordFor reviewing company rules and personal details, and editing Word notices

How to use

Just paste this into your AI.

I want to use the nice to have kit "Employment Notice Kit". Follow https://nicetohave.app/en/g/T4GTSXRC-•••••••••• and set it up.

Works the same in Claude Code or Codex.
Read what this tells your AI to do, before you paste it

If you would rather take the files yourself

Paste the line above and your AI fetches it. If your AI cannot fetch it, or you would rather download it yourself, start here.

Download the kit as a zip

  1. Unpack the zip you downloaded
  2. Open the resulting folder in Claude Code or Codex (in VS Code, "Open Folder")
  3. Type "start building with this kit". The instructions are inside (Claude Code reads CLAUDE.md, Codex reads AGENTS.md)

FAQ

Can I email the notice to the employee?
Handing it over on paper is the default, but if the employee wishes, you may send the PDF by email or similar. The kit stops at making the PDF; a person does the sending.
Can it double as an employment contract that the employee signs?
Yes. At the start you choose "notice only" or "notice that doubles as an employment contract"; the latter adds a signature block at the bottom. It's laid out to fit on one page where possible, so the signature block doesn't end up alone on a second sheet.
Will it tell me whether someone must join social insurance or employment insurance?
No. It flags (△) cases where someone looks eligible but is marked "not enrolled," but that's only a guide. Confirm enrollment with the pension office, Hello Work, or a certified labor and social security attorney.
How long should I keep copies of issued notices?
Five years (three years for the time being). Issued versions are locked against editing, and copies for people who have left are kept too. Drafts can be deleted.
Can this kit also handle work rules or payroll?
No. It doesn't create or change work rules; it writes notices that match them. It also doesn't do payroll or attendance totals, staffing-agency or contractor agreements, or labor-management agreements such as the overtime (Article 36) agreement—though it will tell you when one is needed.

Reviews

Used it? Leave a rating
A few words are optional. A thank-you, or show off what you made. It goes to the maker.
Sign in with GitHub to write

Supporters

Once support opens, the people who backed this kit will be listed here.

Publisher
shuto-shinoda
Published
2026/10/07
Price
Free
Category
Delegate work
Personal data
Handled
Security review
Needed (depends what you handle)
What's inside
The flow that drafts a notice from what you tell itA pre-issue check that flags gaps and minimum-wage shortfalls with ✗/△A tool that finalises the notice as PDF and WordA tool that checks an existing notice template for gapsA ledger watching every contract's end date, conversion to indefinite term, and minimum-wage shortfallsA sample bakery company to try it withA record of fixes found against MHLW's model forms and a real HR system

More kits