StructuredFor ProfessionalsCoding & Tech

Write a technical spec for any new feature or system.

Before starting any significant engineering work — prevents rework, aligns stakeholders, and forces clear thinking

ChatGPT · Claude · Gemini·Intermediate·~1200 tokens
Curated by the AIPP team
Last updated 14 May 2026 · v3
write-a-technical-spec-for-any-new-feature-or-system.md · 1200 words
You are a senior {{role}} brought in to help a professional complete a {{use_case}} task.

# Context
- Category: Coding & Tech
- Use case: Write a technical spec for any new feature or system
- Source task:
  - Write a technical spec for: {{describe_the_feature_or_system}}. Business context: {{why_we_are_building_this_what_problem_it_solves_}}. Stakeholders: {{who_needs_to_review_or_sign_off_on_this_spec}}.
  - Spec format:
  - 1. Problem statement (what breaks or is missing without this).
  - 2. Goals and non-goals (what this spec covers and explicitly does not cover).
  - 3. Proposed solution (high-level architecture or approach : include data flow if relevant).
  - 4. Key design decisions (list 2-3 decisions with the alternatives considered and why this approach was chosen).
  - 5. Data model changes (if applicable : new tables, fields, relationships).
  - 6. API changes (new or modified endpoints).
  - 7. Security and privacy considerations.
  - 8. Testing strategy (unit, integration, and E2E coverage plan).
  - 9. Rollout plan (feature flags, phased release, monitoring plan).
  - 10. Open questions (unresolved decisions that need input before build starts).

# Goal
A complete 10-section technical spec that aligns engineering, product, and stakeholders before a single line is written

# Constraints
- Produce a complete, usable first draft in one response.
- Avoid generic filler, vague advice, and corporate-sounding language.
- Make the output specific, practical, and ready to use.

# Output
A complete 10-section technical spec that aligns engineering, product, and stakeholders before a single line is written

The variables to fill in

PlaceholderWhat to put thereExample
{{role}}Rolestaff engineer who writes technical specs for cross-functional alignment
{{describe_the_feature_or_system}}Describe the feature or systemsystem
{{why_we_are_building_this_what_problem_it_solves_}}Why we are building this what problem it solves why we are building this
{{who_needs_to_review_or_sign_off_on_this_spec}}Who needs to review or sign off on this specwho needs to review
{{use_case}}Your specific valuewrite a technical spec for any new feature or system

How to customize this prompt

  1. Replace each {{double-curly}} with your real context.
  2. Adjust the constraints section to match your tone — formal, casual, blunt.
  3. If the engagement is recurring, change the duration line to mention milestones rather than days.
  4. Run it in your tool of choice. The output should be ready to paste with at most one small edit.

When to use

Before starting any significant engineering work — prevents rework, aligns stakeholders, and forces clear thinking

PRO TIP

Open questions (section 10) are the most important section. If there are none, the spec has either been over-scoped into territory that isn't ready yet — or the author hasn't thought hard enough.

Related prompts

Structured

Blog Post Drafting Engine

Write a complete, SEO-optimised blog post on the given topic. Include a compelling headline, an engaging introduction, 4-5 subheadings with detailed body paragraphs, and a strong conclusion with a cal

Structured

Email Newsletter Writer

Write a complete email newsletter including subject line, preview text, opening hook, main body content (3 short sections), and a clear call to action.

Structured

YouTube Video Script Writer

Write a complete YouTube video script including a strong hook (first 30 seconds), structured main content with transitions, and a closing that encourages likes, comments, and subscriptions.

Structured

LinkedIn Article Builder

Write a complete LinkedIn article that establishes professional authority, shares a genuine insight, and encourages professional discussion.

★ EXPLORE MORE PROMPTS

More for Professionals

Browse all prompts built for Professionals — free and premium, ready to copy.

Browse more prompts →