@hustle-together/api-dev-tools 1.8.0 → 2.0.0

package/README.md

@@ -30,9 +30,9 @@ Six Python hooks that provide **real programmatic guarantees**:
 
 - **`enforce-external-research.py`** - (v1.7.0) Detects external API questions and requires research before answering
 - **`enforce-research.py`** - Blocks API code writing until research is complete
-- **`enforce-interview.py`** - Verifies user questions were actually asked (prevents self-answering)
+- **`enforce-interview.py`** - (v1.8.0+) Verifies structured questions with options were asked; (v1.9.0+) Injects decision reminders on writes
 - **`verify-implementation.py`** - Checks implementation matches interview requirements
-- **`track-tool-use.py`** - Logs all research activity (Context7, WebSearch, WebFetch, AskUserQuestion)
+- **`track-tool-use.py`** - (v1.9.0+) Captures user decisions from AskUserQuestion; logs all research activity
 - **`api-workflow-check.py`** - Prevents stopping until required phases are complete + git diff verification
 
 ### State Tracking
@@ -470,6 +470,34 @@ INJECTS: "RESEARCH REQUIRED: Use Context7/WebSearch before answering"
 CLAUDE: Researches first → Gives accurate answer
 ```
 
+### Gap 7: Interview Decisions Not Used During Implementation (v1.9.0+)
+**Problem:** AI asks good interview questions but then ignores the answers when writing code.
+
+**Example:**
+- Interview: User selected "server environment variables only" for API key handling
+- Implementation: AI writes code with custom header overrides (not what user wanted!)
+
+**Fix:** Two-part solution in `track-tool-use.py` and `enforce-interview.py`:
+
+1. **track-tool-use.py** now captures:
+   - The user's actual response from AskUserQuestion
+   - Matches responses to option values
+   - Stores decisions in categorized `decisions` dict (purpose, api_key_handling, etc.)
+
+2. **enforce-interview.py** now injects a decision summary on EVERY write:
+```
+✅ Interview complete. REMEMBER THE USER'S DECISIONS:
+
+• Primary Purpose: full_brand_kit
+• API Key Handling: server_only
+• Response Format: JSON with asset URLs
+• Error Handling: detailed (error, code, details)
+
+Your implementation MUST align with these choices.
+```
+
+This ensures the AI is constantly reminded of what the user actually wanted throughout the entire implementation phase.
+
 ## 🔧 Requirements
 
 - **Node.js** 14.0.0 or higher
@@ -521,6 +549,21 @@ This is the initial release. Feedback welcome!
 - Custom templates
 - Multi-language support
 
+## 🙏 Acknowledgments
+
+### @wbern/claude-instructions
+The TDD workflow commands (`/red`, `/green`, `/refactor`, `/cycle`) are based on the excellent [@wbern/claude-instructions](https://github.com/wbern/claude-instructions) package by **William Bernmalm**. This project extends those patterns with interview-driven API development, research enforcement hooks, and comprehensive state tracking.
+
+### Anthropic
+The interview methodology is inspired by [Anthropic's Interviewer approach](https://www.anthropic.com/news/anthropic-interviewer) for structured discovery.
+
+### Context7
+Special thanks to the [Context7](https://context7.com) team for providing live documentation lookup that makes research-first development possible.
+
+---
+
+Thank you to the Claude Code community for making AI-assisted development more rigorous!
+
 ## 📄 License
 
 MIT License - Use freely in your projects