{"podcast":{"title":"You've Been a Bad Agent","slug":"you-ve-been-a-bad-agent-7334728","podcast_index_feed_id":7334728,"rss_url":"https://feeds.transistor.fm/bad-agent","website_url":null,"image_url":"https://img.transistorcdn.com/WR6SHMOqkG90n9iPDIbsXb6q0zPpZub3Y0ll4wC0WEg/rs:fill:0:0:1/w:1400/h:1400/q:60/mb:500000/aHR0cHM6Ly9pbWct/dXBsb2FkLXByb2R1/Y3Rpb24udHJhbnNp/c3Rvci5mbS84NGFl/MjgyMzY0ZWJmNjM3/N2M4NmE0M2FjNDk4/MTgyOC5wbmc.jpg","author":"Matt Carey","episode_count":27,"summary":"Wil and Matt discuss tech, startups, and building really cool things with AI. Sometimes joined by (actual expert) friends.","last_synced_at":null,"page_url":"https://stenobird.com/podcast/you-ve-been-a-bad-agent-7334728"},"episode":{"title":"Structuring Codebases for AI, Claude Code in GitHub, Scale Acquired! Granola Cafe, AI Rules and More MCP","slug":"structuring-codebases-for-ai-claude-code-in-github-scale-acquired-granola-cafe-ai-rules-and-more-mcp","published_at":"2025-06-12T08:01:03+00:00","page_url":"https://stenobird.com/podcast/you-ve-been-a-bad-agent-7334728/structuring-codebases-for-ai-claude-code-in-github-scale-acquired-granola-cafe-ai-rules-and-more-mcp","show_page_url":"https://stenobird.com/podcast/you-ve-been-a-bad-agent-7334728","url":"https://share.transistor.fm/s/82181cce","audio_url":"https://media.transistor.fm/82181cce/ad5f58a3.mp3","summary":"To leverage AI coding agents effectively, you must move beyond simple file access and focus on structuring codebases with clear boundaries and trace-based context. The discussion explores how tools like Claude Code and MCP servers can be optimized through better documentation and rule-based instructions.","meta_description":"Learn how to structure codebases for AI agents, use Claude Code with GitHub, and leverage MCP servers for better developer workflows.","key_points":["Main idea: Effective AI coding requires structuring codebases with clear boundaries and high-signal documentation to prevent model confusion","Practical takeaway: Use compact representations of key code transactions (traces) to teach agents which functions and files are critical to core logic","Failure mode: Models struggle with 'cleaning up' after themselves, necessitating strict rule files (like cursor-rules) to prevent unused variables and messy refactors","Technical insight: Using URL-based secrets in MCP servers can bypass the complexities and broken implementations of standard OAuth flows in AI clients","Tooling trend: The rise of subagents in tools like Shippie allows for parallel processing of complex coding tasks across different parts of a codebase"],"chapters":[{"start_ms":60000,"title":"Tech Industry Drama & Meta's Scale Acquisition","summary":"A discussion on the implications of Meta's 49% stake in Scale AI and the strategic importance of data distribution."},{"start_ms":660000,"title":"Codebase Structure for Parallelization","summary":"Exploring how separating testing frameworks, UI components, and logic allows for better parallel processing in AI-driven development."},{"start_ms":900000,"title":"Automating Migrations with Claude Code","summary":"Using Claude Code and custom utility libraries to automate large-scale version migrations and codebase updates."},{"start_ms":1200000,"title":"Stateful AI Tools and Gitli","summary":"Discussing the emergence of stateful development tools and the utility of Gitli for managing developer workflows."},{"start_ms":1800000,"title":"Solving Authentication in MCP Servers","summary":"Analyzing the Supermemory MCP approach to using URL-based secrets to avoid broken OAuth and Bearer token implementations."},{"start_ms":2640000,"title":"Enforcing Strict Coding Standards via Rules","summary":"The necessity of using rule files to prevent models from introducing unused variables and unoptimized code."},{"start_ms":3180000,"title":"Context-Aware Agents and Trace-Based Learning","summary":"The future of coding agents: providing models with traces of key transactions to improve understanding of complex logic flows."}],"topics":["Claude Code","Model Context Protocol","AI Coding Agents","Software Architecture","MCP Servers","Codebase Refactoring","Developer Tooling","Automated Migrations"],"duration_seconds":3826,"processing_state":"processed","actions":[{"name":"request_transcript","method":"POST","url":"https://stenobird.com/v1/public/podcasts/you-ve-been-a-bad-agent-7334728/episodes/structuring-codebases-for-ai-claude-code-in-github-scale-acquired-granola-cafe-ai-rules-and-more-mcp/transcription-requests","description":"Idempotently request low-priority transcript generation for this episode."},{"name":"read_markdown","method":"GET","url":"https://stenobird.com/podcast/you-ve-been-a-bad-agent-7334728/structuring-codebases-for-ai-claude-code-in-github-scale-acquired-granola-cafe-ai-rules-and-more-mcp.md","description":"Read the agent-friendly Markdown representation of this episode resource."}]}}