Ty

Typed Natural Language – A better plan mode with workflow for coding

Hacker News

Typed Natural Language – A better plan mode with workflow for coding

Plan mode in Claude Code / Codex works, for one session. Next session, your agent re-reads source and re-derives the same decisions you already made. TNL (Typed Natural Language) is that same review-before-code discipline, but persistent: a short English contract with a fixed schema (paths, behaviors with MUST/SHOULD/MAY/[semantic], non-goals), proposed by the agent, approved by you, implemented against, saved on disk, and read by every future session. It's not a new agent or tool, it slots into whatever you already use. npx typed-nl init adds a workflow stanza to your CLAUDE.md / AGENTS.md / GEMINI.md, scaffolds a tnl/ directory, and optionally wires a PreToolUse hook and MCP server. The minimum product is a stanza + a folder. Hooks, MCP, and tnl verify (CI gate for path and test-binding integrity) are optional layers. We ran a controlled A/B on an existing 16KLOC Python codebase, event-driven triggers, a 35-scenario behavioural matrix, deliberately ambiguous prompt. Both Baseline and TNL conditions got the same coding discipline in their instruction file; Same agent, same model, same base commit. Results: Agent TNL Baseline Gap Claude Opus 4.7 (R1) 35/35 29/35 +6 Claude Opus 4.7 (R2) 31/35 27/35 +4 Claude Opus 4.7 (R3) 30/35 25/35 +5 Codex GPT-5.4 (R1) 32/35 26/35 +6 Codex GPT-5.4 (R2) 31/35 26/35 +5 No overlap: TNL's lowest paired cell is 86%, baseline's highest is 83%. Other signals: Follow-up work: on round-2 tasks in the same worktrees, TNL agents edited the existing contract (4/4 samples); baseline re-read source. Caveats: small n, LLM sessions are noisy, and we built the tool. Every script, prompt, raw JSON, and session transcript is committed. We dogfooded it, every feature of the tool itself has its own TNL in tnl/. Install: npx typed-nl init Repo: https://github.com/janaraj/tnl npm: https://www.npmjs.com/package/typed-nl Happy to answer questions, especially from people who've tried plan-mode workflows and want to know where this differs.

Share card

Actual performance

2points
Did not reach leaderboard

Launch Intel predictions

Analyze your own launch →
Product HuntOn track for Day 1 leaderboard · Strong signals: agents, agent, claude · Missing: mac, macos, cursor
97%97% predicted probability of success on Product Hunt, based on ML models trained on real launch data.
best fitHighest predicted score across all platforms for this description.
Indie HackersFits the IH revenue-focused audience · Strong signals: gemini · Missing: supports, reddit linkedin, podcasting
73%73% predicted probability of success on Indie Hackers, based on ML models trained on real launch data.
TrustMRRFits verified-revenue profile · Missing: mobile apps, ios, personal
51%51% predicted probability of success on TrustMRR, based on ML models trained on real launch data.
Hacker NewsMay not resonate with HN audience · Strong signals: exist, existing, io · Missing: https docs, excited, just released
29%29% predicted probability of success on Hacker News, based on ML models trained on real launch data.
nativeThis product was originally launched on this platform.
Acquire.comPre-revenue stage for this audience · Missing: arr, mrr, revenue
24%24% predicted probability of success on Acquire.com, based on ML models trained on real launch data.
AppSumoMay struggle as an AppSumo deal · Missing: plus, platform, intuitive
23%23% predicted probability of success on AppSumo, based on ML models trained on real launch data.
BetaListMay not resonate with beta-testers · Missing: web3, chat, crypto
0%0% predicted probability of success on BetaList, based on ML models trained on real launch data.

Correct prediction on native model

Similar products

Na
Natural Language Querying43%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Natural Language Querying

Hacker News17
Wi
Wit – Natural language for your app45%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Wit – Natural language for your app

Hacker News321
Be
Beaches of Greece, natural-language search for Greek beaches51%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Beaches of Greece, natural-language search for Greek beaches

Hacker News1
Ma
Make GLSL Shaders with natural language52%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Make GLSL Shaders with natural language

Hacker News1
Tw
Twitch plays Codebuff – a natural language coding experiment67%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Twitch plays Codebuff – a natural language coding experiment

Hacker News11
Se
Selecta – Natural language analytics for BigQuery55%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Selecta – Natural language analytics for BigQuery

Hacker News1
Ex
Explore Cellular Automatons with Natural Language49%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Explore Cellular Automatons with Natural Language

Hacker News1
Fo
Fountain – Natural Language Data Augmentation Tool51%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Fountain – Natural Language Data Augmentation Tool

Hacker News1
Ba
Babo – A scripting natural language that works as intended50%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Babo – A scripting natural language that works as intended

Hacker News6
NL
NLCS – A Natural Language Constraint System for LLMs53%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

NLCS – A Natural Language Constraint System for LLMs

Hacker News3