hedgehog-loop

Enforce a test-driven development lifecycle for TypeScript full-stack applications.

26|4|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/skyf0xx/hedgehog --skill hedgehog-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hedgehog-loop
Source: https://github.com/skyf0xx/hedgehog/tree/main/src/skills/hedgehog-loop
Command: npx skills add https://github.com/skyf0xx/hedgehog --skill hedgehog-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the issue of architectural drift and context loss in AI-assisted development by enforcing a strict, step-by-step Test-Driven Development (TDD) workflow.

Core Features & Use Cases

  • Mechanical Enforcement: Uses phase gates and a predefined build order to ensure every layer of an application is verified before moving forward.
  • Domain Module Pattern: Organizes code into isolated modules with clear boundaries, ensuring that services and repositories remain decoupled and testable.
  • Use Case: When building a new feature, the Skill guides the AI to build the schema, contract, repository, service, and controller in sequence, ensuring the codebase remains structured and maintainable as it grows.

Quick Start

Initiate the Hedgehog loop to begin building the next module step defined in the project TODO.md file.

Frequently Asked Questions about hedgehog-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce TDD in AI-assisted TypeScript development?

To prevent architectural drift in AI-assisted builds, enforce a strict, step-by-step Test-Driven Development lifecycle using mechanical phase gates that require verified, tested, and committed steps for every domain module before moving forward.

What is the best way to structure a full-stack TypeScript codebase for AI agents?

The best way to structure a full-stack TypeScript codebase for AI agents is using a domain module pattern, organizing code into isolated modules with clear boundaries to keep services and repositories decoupled and testable as the project scales.

How do I sequence backend and frontend builds in an automated workflow?

Sequence backend and frontend builds in an automated workflow by defining a strict build order that guides the AI to build the schema, contract, repository, service, and controller in sequence, ensuring architectural integrity through mechanical gating.

Does this TDD workflow require a specific project structure or setup?

This TDD workflow requires a TypeScript-based full-stack application setup and relies on a predefined project TODO.md file to define and track the sequential build steps for each domain module within the architecture.

Why does my AI coding assistant lose context and break architecture in large projects?

AI coding assistants lose context and break architecture in large projects due to context loss, which is mitigated by enforcing a strict, step-by-step Test-Driven Development workflow with conventional commit standards for every domain module.