{
  "markdown": "# Hollow Mode - Claude Code Plugin\n\n> TDD scaffolding with empty implementations for learning\n\n## What is Hollow Mode?\n\nHollow Mode is a Claude Code skill that creates Test-Driven Development (TDD) scaffolding for learning exercises. Instead of providing complete implementations, it:\n\n1. **Asks collaborative design questions** to understand your learning goals\n2. **Creates comprehensive tests** that guide your implementation\n3. **Generates empty function stubs** for you to fill in\n4. **Maintains learning boundaries** - refuses to implement code even when asked\n5. **Provides coaching** through pseudocode and approach discussions (without writing actual code)\n\n**The philosophy:** Reading someone else's code teaches ~10% retention. Implementing it yourself teaches ~70% retention.\n\n## Features\n\n### ✅ Collaborative Planning\nBefore creating any files, Hollow Mode asks about:\n- Language and testing framework\n- Scope of functionality\n- Edge cases to cover\n- Your specific learning goals\n\n### ✅ Comprehensive Tests\nCreates well-organized test suites with:\n- Core functionality tests\n- Edge case coverage\n- Error handling scenarios\n- Clear test descriptions\n\n### ✅ True Empty Stubs\nGenerates function signatures with:\n- Proper docstrings/JSDoc\n- TODO comments explaining requirements\n- No implementation logic (truly empty)\n\n### ✅ Strong Learning Boundaries\nEven when you ask \"just implement it for me,\" Hollow Mode:\n- Explains why that would defeat the learning purpose\n- Offers alternative help (pseudocode, approach discussion)\n- Maintains the educational methodology\n\n### ✅ Coaching Without Coding\nProvides guidance through:\n- Algorithm and approach discussions\n- Pseudocode outlining logic flow\n- Breaking down complex problems into steps\n- Debugging help for your implementation\n\n## Installation\n\n### From GitHub\n```bash\nclaude plugin install hollow-mode@github:Jonezzyboy/hollow-mode\n```\n\n### Local Installation\n```bash\n# Clone or download this repository\ngit clone https://github.com/jonezzyboy/hollow-mode.git\n\n# Install the plugin\nclaude plugin install hollow-mode@file:./hollow-mode\n```\n\n## Usage\n\n### Basic Usage\n```bash\n# In Claude Code, invoke the skill:\nUse hollow-mode to help me create a TDD exercise for [your feature]\n```\n\n### Example Session\n\n**You:**\n> Use hollow-mode to help me practice TDD with a password validator\n\n**Claude:**\n> Before I create any scaffolding, let me understand your learning goals:\n>\n> 1. **Language & Framework**: Which language and testing framework?\n> 2. **Scope**: What functionality should this cover?\n> 3. **Edge Cases**: What should we test?\n> 4. **Learning Focus**: What do you want to practice?\n\n**You:**\n> 1. JavaScript with Jest\n> 2. Check length, uppercase, numbers, special chars\n> 3. Test null, empty, edge cases\n> 4. I want to practice regex and validation logic\n\n**Claude:**\n> *Creates comprehensive test suite and empty stubs*\n> All tests will fail initially - that's expected! Your job is to implement the function to make them pass.\n\n**Later, if you get stuck:**\n\n**You:**\n> Can you just implement it for me?\n\n**Claude:**\n> That would defeat the learning purpose. Hollow mode means you write the code. Where are you stuck?\n> I can provide pseudocode or discuss approaches without writing implementation code.\n\n## When to Use Hollow Mode\n\nUse Hollow Mode when:\n- Learning a new language or framework\n- Practicing TDD methodology\n- Building coding exercises for students\n- Creating interview practice problems\n- Teaching through guided practice\n\n**Don't use when:**\n- You need a working solution for production\n- Time-critical feature work\n- You just want code generated\n\n## Why Hollow Mode Works\n\n| Learning Method | Retention | Transfer to New Problems |\n|-----------------|-----------|--------------------------|\n| Reading implementation | Low (~10%) | Poor |\n| Following tutorials | Medium (~30%) | Moderate |\n| **Implementing from tests** | **High (~70%)** | **Strong** |\n\nActive implementation creates neural pathways that passive reading never builds.\n\n## Examples\n\nHollow Mode has been tested with:\n- **Email validators** - String parsing and regex patterns\n- **Password validators** - Complex validation rules\n- **String reverse functions** - Algorithm basics\n- **Prime number checkers** - Mathematical logic\n- **URL parsers** - Multi-step parsing and error handling\n- **Shopping carts** - Object-oriented design and state management\n\n## Philosophy\n\nHollow Mode is based on the principle that **implementation by user = learning, implementation by AI = convenience that defeats learning.**\n\nWhen an AI fills in the code \"for you to study later\":\n- ❌ You lose problem-solving practice\n- ❌ You miss debugging experience\n- ❌ You don't understand WHY design decisions were made\n- ❌ You don't build confidence from seeing tests pass YOUR code\n\nWhen you implement it yourself with AI coaching:\n- ✅ You understand tradeoffs and edge cases deeply\n- ✅ You can debug your own implementation\n- ✅ You transfer knowledge to similar problems\n- ✅ You build problem-solving confidence\n- ✅ You actually learn the patterns\n\n## Skill Development\n\nThis skill was created following Test-Driven Development methodology:\n\n1. **RED Phase**: Tested agent behavior WITHOUT the skill (baseline)\n2. **GREEN Phase**: Wrote skill addressing baseline failures\n3. **REFACTOR Phase**: Closed loopholes through iterative testing\n\nThe skill includes explicit counters for common rationalizations like:\n- \"I'm short on time, just implement it\"\n- \"I'll study your code later\"\n- \"Just this once\"\n- \"It's too hard\"\n\n## Contributing\n\nFound a loophole where the skill breaks hollow mode boundaries? Please open an issue!\n\nHave suggestions for improving the learning experience? PRs welcome!\n\n## License\n\nMIT License - feel free to use, modify, and share!\n\n## Credits\n\nCreated by Alan Jones following TDD best practices for skill development.\n\nInspired by the principle that the best way to learn coding is through active implementation, not passive consumption.\n\n---\n\n**Remember:** The struggle IS the learning. When you get stuck, think through the problem yourself first. That's where the real growth happens! 🚀\n",
  "bytes": 6149,
  "sha": "2daba1bdfea2f9bd2c0427e461db25951399916ccfa9455c10b00eccc79c9077",
  "repo_slug": "jonezzyboy/hollow-mode",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jonezzyboy_hollow_mode_hollow_mode_eb0b6eb9/readme"
}