frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

Show HN: sudocode – manage specs, tasks, and context-as-code for coding agents

https://github.com/sudocode-ai/sudocode
14•alexsngai•1h ago
sudocode is a lightweight context management system for coding agents that lives in your repo. It helps organize the chaos of human-AI collaboration by capturing user intent as durable specs and tracking agent activity as issues, all version-controlled with Git. This "context-as-code" approach reduces agent amnesia and accelerates development on long-horizon tasks.

Comments

arcticampic•1h ago
nice
ishita159•44m ago
have tried it, i think's focusing on spec-driven development?
alexsngai•1m ago
yes! sudocode manages agents at different levels of abstraction. You can steer agents at the `spec` level by building up a spec that contains your intent and requirements, then generate `issues` that capture the implementation details. However you aren't limited to that pattern. You can also just manage agents at the `issue` level to better manage their execution state (think something like a kanban board).

In general, sudocode aims to preserve some of this implementation/planning state (context-as-code) in your codebase so it isn't lost in your chat logs. Keeping this context in your repo makes it accessible to coding agents long after code changes were made, so it functions as a sort of episodic memory for your codebase.

wintonzheng•28m ago
Does "durable spec" mean writing the spec in a MD file and committing to a repo?

The big problem of ai generated docs for me is that it takes time to read and understand whether they are correct or not. Same with human written docs, which is why you need spec reviewers.

I assume the purpose of sudocode is to help me reduce the time to review and manage specs. How can sudocode help me solve the trust problem here while i don't want to spend so much time reading and managing specs? Solving the spec generation is one part, but the other big problem to solve here is to help speed up the spec review/validation process.

alexsngai•6m ago
I think of specs as a combination of user intent + context that might be relevant for the issue. The expansion of the spec into a full-fledged document, whether thats agent-written or human-written can be flexible as long as it contains the original user intent and requirements (so it becomes useful input to any coding agents handling the implementation).

In this case, what sudocode aims to preserve is the human intent that might be lost in agent chat logs, etc. It then provides utilities to turn those specs into implementation plans (issues). And specs in this case are mutable and designed to be iterated on (just like code).

Or with a physics analogy, the code is the position of a particle while the specs capture velocity information. You can iteratively work on changing the velocity which will then change the position (code changes).

As for the spec review burden, the sudocode provides an interface for coding agents to provide bi-directional feedback onto the original spec, so you can fire off a few coding agents and see how they performed relative to your specified requirements. You can let the execution of the coding agents speak for themselves!

3D Geological Models in Minecraft

https://www.bgs.ac.uk/discovering-geology/maps-and-resources/maps/minecraft-3d-geological-models/
1•michaefe•2m ago•0 comments

High-speed rail network possible by 2040, says European Commission

https://www.theguardian.com/world/2025/nov/05/high-speed-european-rail-network-could-be-possible-...
1•rob74•2m ago•0 comments

Return of Chinese astronauts delayed after spacecraft struck by debris

https://www.theguardian.com/world/2025/nov/05/chinese-astronauts-delayed-spacecraft-struck-by-deb...
1•mitchbob•4m ago•0 comments

New gel restores dental enamel and could revolutionise tooth repair

https://www.nottingham.ac.uk/news/new-gel-restores-dental-enamel-and-could-revolutionise-tooth-re...
12•CGMthrowaway•7m ago•0 comments

Light Has Burst Forth in Astonishing Abundance

https://newsletter.humanprogress.org/p/light-has-burst-forth-in-astonishing
1•surprisetalk•7m ago•0 comments

Twtxt – decentralised, minimalist microblogging service for hackers

https://twtxt.readthedocs.io/en/latest/user/intro.html
1•surprisetalk•7m ago•0 comments

An overview of Air filter classes

https://coffee.link/air-filter-classifications-and-what-they-actually-mean/
1•PhilKunz•8m ago•0 comments

Apple nears $1B Google deal for custom Gemini model to power Siri

https://9to5mac.com/2025/11/05/google-gemini-1-billion-deal-apple-siri/
1•jbredeche•8m ago•0 comments

Fiber reduces overall mortality by 23%

https://www.empirical.health/blog/dietary-fiber-reduces-all-cause-morality/
2•brandonb•9m ago•0 comments

Superconducting qubit that lasts for over 1 ms is primed for industrial scaling

https://phys.org/news/2025-11-superconducting-qubit-millisecond-primed-industrial.html
1•rbanffy•10m ago•0 comments

Liquid Glas can be tweaked now

https://www.theverge.com/news/812375/apple-iphone-ios-26-1-update-availability
1•PhilKunz•10m ago•0 comments

Our Precious

https://www.overcomingbias.com/p/our-precious
1•jger15•10m ago•0 comments

Improving Agent with Semantic Search

https://cursor.com/blog/semsearch
1•ecz•13m ago•0 comments

NATS 2.12 Atomic Batch Publishing

https://qaze.app/blog/nats-batch-publish/
1•SebastianM•15m ago•0 comments

Tinder is testing an AI feature that learns about you from your Camera Roll

https://techcrunch.com/2025/11/05/tinder-to-use-ai-to-get-to-know-users-tap-into-their-camera-rol...
2•gloxkiqcza•18m ago•0 comments

Berkeley Police Department Transitioning to Encrypted Radio Communications

https://local.nixle.com/alert/11979725/
3•7402•20m ago•0 comments

The most life-changing books, statistically

https://residualthoughts.substack.com/p/a-statistical-guide-to-the-most-life
1•tristanMatthias•22m ago•0 comments

NIU's scooter-sized electric microcar is headed for production

https://electrek.co/2025/11/04/nius-scooter-sized-electric-microcar-is-actually-headed-for-produc...
1•harambae•23m ago•0 comments

Apple launches rich new web interface for the App Store

https://9to5mac.com/2025/11/03/apple-launches-rich-new-web-interface-for-the-app-store/
3•janandonly•24m ago•0 comments

Ask HN: What modern techniques do you use to improve your site's SEO?

1•01-_-•26m ago•0 comments

Show HN: Kumi – a portable, declarative, functional core for business logic

https://kumi-play-web.fly.dev/?example=monte-carlo-simulation
1•goldenCeasar•30m ago•0 comments

Metalang99: A rich functional language implemented in C99 preprocessor

https://github.com/hirrolot/metalang99
2•PaulHoule•31m ago•0 comments

CareerJourney – your personal career command centre

https://career-journey.app/
1•sebi-secasiu•32m ago•1 comments

Googling "phind" exposed a random chat URL in search results

https://www.phind.com/search/k5tn3mqv62xn11d7c7gy9189
2•lodedeyn•32m ago•0 comments

PolyForm Noncommercial 2.0.0-Pre.2

https://writing.kemitchell.com/2025/11/05/PolyForm-Noncommercial-2.0.0-pre.2
2•feross•33m ago•0 comments

I'm Betting $100M on a New University

https://www.thefp.com/p/im-betting-100-million-on-a-new-university
4•ttcbj•37m ago•3 comments

State of Doltgres

https://www.dolthub.com/blog/2025-10-16-state-of-doltgres/
1•janpio•37m ago•0 comments

Apple Plans to Use 1.2T Parameter Google Gemini Model to Run New Siri

https://www.bloomberg.com/news/articles/2025-11-05/apple-plans-to-use-1-2-trillion-parameter-goog...
4•mfiguiere•38m ago•0 comments

Automating our home video imports

https://pierce.dev/notes/automating-our-home-video-imports
1•icyfox•38m ago•0 comments

Yansu – The Serious Coding Plaftorm

https://yansu.isoform.ai/
6•janpio•38m ago•1 comments