Eye of the Storm
Archive
Series

Research, in arcs

AI Basics16 posts
A ground-up introduction to working with AI tools — from prompting fundamentals to integrating AI into your development workflow.
Building in Public2 posts
Behind-the-scenes posts on how this devblog gets built — workflow, tooling, and the decisions behind the decisions.
LLM Driven SDLC1 post
How large language models are reshaping every phase of the software development lifecycle — from requirements and planning through implementation, review, testing, and deployment. A practitioner's view of what actually changes when AI enters the loop.
AI Engineering Research2 posts
Deep-dive research notes on building AI-powered tools — from designing LLM-driven requirements generators to understanding architecture, inference, and production AI systems.
On GitHub

Projects in flight

codagatchiTypeScript
A tamagotchi-style desktop pet built with Tauri — a small always-on-top companion whose stats decay in real time and need tending.
groundworkTypeScript
SDLC discipline plugin for Claude Code — requirements, plans, and structured development workflows.
— Updated as projects evolveAll research & projects
ActivityAbout
GitHubXRSS
© 2026 stormbreaker9000 · charted with care
Projects

// project

groundwork

My attempt at making a claude code plugin that helps users adhere to a set of SDLC standards

★ 1 · ⑂ 0 · ● 0 open
Pythonpushed 2026-08-24T18:46:25ZView on GitHub ↗

README

A Claude Code plugin that brings structure to software development — requirements gathering, planning, and SDLC discipline before you write a line of code.

Built as an alternative to "vibe coding": lay the groundwork first.

What it does

Groundwork intercepts vague implementation requests and guides you through a lightweight requirements process before anything gets built. Instead of jumping straight to code, you get a structured brief with acceptance criteria that both you and Claude agree on.

Installation

From Claude Code:

/plugin marketplace add https://github.com/Stormbreaker9000/groundwork

Then install the plugin:

/plugin install groundwork@groundwork-dev

Usage

Run /groundwork in any Claude Code session to see available workflows.

When you make a vague request like "build me a login form" or "add dark mode", the requirements skill will pause and ask clarifying questions before touching code.

Workflows

WorkflowTriggerDescription
requirements"build X", "add Y", "make it do Z"Turns vague requests into a structured brief with acceptance criteria before any code is written

Requirements Brief format

## Requirements Brief

**Problem:** [One sentence: what breaks or is missing and for whom]

**Acceptance Criteria:**
- [ ] [Specific, testable condition]

**Constraints:** [What this must not do or must stay within]

**Out of Scope:** [What will not be addressed in this change]

Claude will not write code until you sign off on the brief.

Roadmap

  • Architecture design workflow
  • Test planning workflow
  • Release checklist workflow
  • PreToolUse hooks to enforce requirements brief before implementation
  • requirements-analyst agent for fully autonomous requirements gathering

Plugin structure

groundwork/
├── .claude-plugin/       # Plugin manifests
├── skills/               # Markdown instruction sets (skill triggers)
├── commands/             # Slash commands (/groundwork)
├── hooks/                # Event-driven scripts (SessionStart)
└── agents/               # Dispatched subagents

License

MIT

Read the full README on GitHub ↗

Recent Commits

  • 6e94c26fix(sto-101): C4 generator follow-ups — stale-file identity, container R…Mark D'Adamo · Aug 24
  • 7b6800bfeat(sto-101): C4 model views as Mermaid diagrams (context, container, c…Mark D'Adamo · Aug 24
  • f955672feat(sto-208): design content-quality linter (M2 analogue of STO-136) (#…Mark D'Adamo · Aug 22
  • d17cd1dfeat(sto-216): declare interaction per operation, not per contract (#15)Mark D'Adamo · Aug 15
  • 47f6280feat(sto-102): cross-artifact traceability validation (design ↔ requirem…Mark D'Adamo · Aug 08
  • f28f8b3feat(sto-100): ADR generation (MADR 4.0) as a third design-artifact type…Mark D'Adamo · Aug 04
  • 96896c3feat(sto-217): capability and interface granularity heuristics (#12)Mark D'Adamo · Aug 03
  • 7a3a4acfix(sto-215): move the structural gate from the critic to the formatter …Mark D'Adamo · Aug 03

Related Posts

  • Groundwork Dev Log 2: Closing the Gaps the Tamagotchi FoundJul 13A while back I ran a desktop tamagotchi through Groundwork's requirements workflow and wrote down everything it got wrong. This is the re-run — same pet, same prompt, after building the fixes.
  • Dev Log: Building GroundworkJun 11Dogfooding Groundwork's requirements workflow on Codagatchi: the baseline it generated, and — graded against my requirements research — exactly where the gaps are to fix next.