Show HN: AI SDLC Scaffold, repo template for AI-assisted software development

I built an open-source repo template that brings structure to AI-assisted software development, starting from the pre-coding phases: objectives, user stories, requirements, architecture decisions. It’s designed around Claude Code but the ideas are tool-agnostic. I’ve been a computer science researcher and full-stack software engineer for 25 years, working mainly in startups. I’ve been using this approach on my personal projects for a while, then, when I decided to package it up as scaffold for more easy reuse, I figured it might be useful to others too. I published it under Apache 2.0, fork it and make it yours. You can easily try it out: follow the instructions in the README to start using it. The problem it solves: AI coding agents are great at writing code, but they work much better when they have clear context about what to build and why. Most projects jump straight to implementation. This scaffold provides a structured workflow for the pre-coding phases, and organizes the output so that agents can navigate it efficiently across sessions. How it works: Everything lives in the repo alongside source code. The AI guidance is split into three layers, each optimized for context-window usage: 1. Instruction files (CLAUDE.md, CLAUDE. .md): always loaded, kept small. They are organized hierarchically, describe repo structure, maintain artifact indexes, and define cross-phase rules like traceability invariants. 2. Skills (.claude/skills/SDLC-*): loaded on demand. Step-by-step procedures for each SDLC activity: eliciting requirements, gap analysis, drafting architecture, decomposing into components, planning tasks, implementation. 3. Project artifacts: structured markdown files that accumulate as work progresses: stakeholders, goals, user stories, requirements, assumptions, constraints, decisions, architecture, data model, API design, task tracking. Accessed selectively through indexes. This separation matters because instruction files stay in the context window permanent

原文链接: HackerNews