Doc template · Software engineers
Technical design doc
An RFC for an engineering change. Made from one message, so you can get your own in minutes.
Technical design doc
RFC-031: Lease-Based Reservations for Brindle Lockers
Context and problem
Brindle Lockers runs 2,400 smart parcel lockers across 310 sites. Today the carrier API writes a reservation row, and each cabinet controller polls `/v1/doors/state` every 5 seconds to learn which doors to open. Nothing prevents two carriers from claiming the same free door in the same polling window.
In March 2026 this produced 1,897 double-assignments out of 271,400 drops (0.7%). Each one triggers a support ticket and a manual re-route costing about $6.40. Polling also means a door-state change can take up to 5 seconds to appear in the customer app.
Goals and non-goals
Goals
• Guarantee at most one active reservation per door, enforced by the database.
• Cut door-state propagation to under 500 ms at p95.
• Reduce double-assignments to below 0.02% of drops.
An RFC for an engineering change
The prompt
Create a Doc technical design document for replacing Brindle Lockers' polling-based locker reservation sync with a lease-based Reservation Service and an event stream, so that no two parcels are ever assigned to the same locker door. Include context and problem, goals and non-goals, the proposed design with components and data flow, alternatives considered, API or schema changes in code blocks, rollout and migration plan, risks, and open questions.
Make it yours
- Change the details in the prompt to fit software engineers.
- For example, change it so that it is for a hospital moving its operating-room scheduling from nightly batch jobs to an event-driven service and the schema code blocks use MongoDB documents instead of SQL.
- Ask for edits in plain words: tone, colors, length, layout or data.
- Share the result by link or export it when you are done.
More doc templates
Browse all
Tidepool Lab Launch Readiness Sync
Marrow Bay Science Center · Exhibits Team · Meeting notes
Attendees
Purpose
Confirm that the Tidepool Lab gallery is on track for its public opening on Saturday, June 6, 2026. We reviewed the open risks (equipment delays, the animal arrival window and staffing) and agreed who owns each next step.
Agenda
Discussion Notes
1. Fabrication status
• Three of the four touch-tank basins are sealed and leak-tested. Basin 4 is scheduled for sealing on April 21.
Meeting notes
Agenda, decisions and action items
Predictive Maintenance Pilot for the Machining Floor
Prepared for: Executive Leadership Team · Prepared by: Dennis Achterberg, Plant Operations Manager · Date: May 4, 2026 · Decision needed by: May 12, 2026
Executive Summary
Unplanned machine stoppages cost Brannock Precision an estimated $704,000 in lost throughput in 2025. We propose a six-month pilot that places vibration and temperature sensors on our 12 highest-volume CNC machines and uses the data to flag failures days before they happen.
The total investment is $159,920. If the pilot cuts unplanned downtime by 30%, it recovers about $211,000 a year and pays for itself within ten months of going live. We are asking leadership to approve the budget and a June 1 start.
Background and Problem
Our 12 pilot machines produce 68% of plant revenue. Today we service them on fixed calendar schedules, which means we sometimes replace parts that are still healthy and miss failures that develop between inspections.
• 612 hours of unplanned downtime on these machines in 2025
• $1,150 per hour in lost throughput, overtime and expedited freight
Project proposal
Goals, scope, timeline and budget
Gillroot Farms: Business Plan 2026–2029
*Fresh gourmet mushrooms, grown indoors and delivered within 24 hours of harvest to the Twin Cities.*
Executive Summary
Gillroot Farms is a climate-controlled indoor mushroom farm that supplies independent restaurants, neighborhood grocers and subscription households in Minneapolis–St. Paul. Most mushrooms sold in Minnesota travel 1,500+ miles and arrive 5–8 days after harvest. We deliver in under 24 hours, with longer shelf life and specialty varieties that buyers can't reliably source today.
We are raising $850,000 to build out a 4,500 sq ft facility, reaching $1.46M in revenue and positive EBITDA by Year 3.
Company Description
Gillroot Farms is a Minnesota LLC with a leased, pre-inspected warehouse bay at 1840 Marshall Street NE. The facility has three-phase power, floor drains and a loading dock, which cuts build-out time to about 14 weeks. Our mission is to make local, peak-fresh specialty mushrooms as easy to buy as a case of onions.
Market Analysis
• Restaurants: about 410 independent full-service restaurants in the Twin Cities spend an estimated $6,000–$18,000 a year on specialty produce.
Business plan
A complete plan for a new venture
Tobias Wennerström
Warehouse Operations Supervisor → Regional Logistics Operations Manager
tobias.wennerstrom@mail.example · (614) 555-0178 · Columbus, Ohio · linkedin.example/in/twennerstrom
• ---
Profile
Operations leader with 9 years in high-volume distribution, from the dock floor to supervising a 46-person, three-shift fulfillment center. Known for lifting on-time shipping, cutting damage and overtime, and building crews that stay. Ready to take on multi-site accountability across a regional network.
Experience
Warehouse Operations Supervisor · Calder Ridge Distribution
*Columbus, OH · March 2021 – Present*
Resume
A clean, results-focused CV
Wren Adeyemi-Larsen
Portland, OR · wren.adeyemi@mail.example · 503-555-0148 · wrenadeyemi.example
March 18, 2026
Dr. Lena Halvorsen, Director of Exhibits
Pelican Point Science Center
220 Harbor Spit Road, Port Alder, OR 97431
Re: Exhibit Developer, Coastal Ecosystems
Dear Dr. Halvorsen and the hiring team,
Last July I stood in your Tideline Gallery for two hours and watched a seven-year-old refuse to leave the sea star table. He wasn't being told anything. He was *noticing*: how the arms curled, why the water felt colder near the rocks, and what the empty shell meant. That is the kind of curiosity Pelican Point protects, and it is why your open Exhibit Developer role is the one I have been hoping to see. Your commitment to exhibits that visitors can touch, test and argue about, rather than read and walk past, is exactly how I learned to teach.
Cover letter
A tailored letter for a job
Offline Trail Packs
Problem statement
Cairn works well until the signal drops. In Q1 2026, 38% of support tickets (1,140 of 3,000) came from hikers whose map stopped loading mid-trail. Our current "save route" feature caches only the tiles a user has already viewed, so the map goes blank exactly where people need it most: past the trailhead, at a junction, in fog.
Competitors let users download whole regions, and 22% of churned Cairn Plus subscribers in 2025 named this gap in exit surveys.
Goals and non-goals
Goals
• Let any user download a complete region (maps, trail data, elevation profiles) in under three taps.
• Keep downloaded data fresh without manual work.
• Cut "map won't load" support tickets by at least half.
Product requirements (PRD)
Problem, users, scope and specs