# progressive-disclosure

Claude Code engineer Thariq shares a year of agent tool design lessons: three failed attempts at question-asking, Todo Lists becoming constraints, replacing RAG with Grep, and expanding capabilities without adding tools.

For vibe note-taking to work well, you must force Claude Code to be 'picky.' Use a 4-layer filtering mechanism (file tree → YAML descriptions → outline → full content) to make it more selective. This pattern is called Progressive Disclosure.