Article based on video by
Most AI coding tutorials show you chatbots that answer questions. Matt Pocock built a 170,000-star open-source project where AI becomes a full development partner—reading documentation, writing specifications, generating tickets, and reviewing code. I spent a week exploring the Skills repository to understand what makes this workflow fundamentally different from generic AI assistants, and the answer lies in two unconventional features most tutorials completely skip.
📺 Watch the Original Video
What Is the AI Coding Workflow?
The AI coding workflow isn’t what most people expect. Forget the image of pasting code into ChatGPT and hoping for the best. Matt Pocock’s Skills repository—now sitting at 170,000 GitHub stars—represents something fundamentally different: a complete system where AI doesn’t just answer questions, it owns parts of the development process.
The End-to-End Development Philosophy
Here’s what surprised me when I first explored this approach: most AI coding assistants treat development like a vending machine. You put in a question, you get out code. The Skills approach treats AI more like a sous chef—someone who doesn’t just hand you ingredients, but actively participates in preparing the whole meal.
The workflow spans from initial documentation review through specification writing, ticket creation, implementation, and code review. Each stage has explicit AI involvement, structured in a way that forces you to be intentional rather than just prompting ad-hoc whenever you feel stuck.
This is where most tutorials get it wrong, by the way. They show you neat prompts, not systems. The Skills repository shows you a system.
Why Open-Source Structure Matters
That 170k-star milestone tells you something important: this isn’t a toy project or a influencer demo. Thousands of development teams have validated this methodology in production environments. The open-source structure means you’re not locked into someone’s proprietary ecosystem—you’re adopting a philosophy that you can inspect, modify, and adapt to your own stack.
Sound familiar? Most teams I’ve seen struggle with AI adoption because it’s scattered—someone uses one tool for refactoring, another for documentation, with no coherent strategy connecting them. The Skills workflow solves this by providing a unified structure that scales from solo projects to team environments.
What you’re really getting with this approach is a forcing function for better development habits.
Why ‘Grill with Docs’ Changes Documentation Forever
I’ve watched countless teams ship features only to discover the requirements were ambiguous, contradictory, or just flat-out missing. The root cause? Documentation got written after the thinking was done, when it should have been the other way around.
Matt Pocock’s “Grill with Docs” approach flips this entirely. Before touching code, you interrogate your existing documentation like a journalist investigating a story. You ask: What does this actually mean? What did the author assume I would understand? Where are the edge cases buried in silence?
Documentation as a First-Class Citizen
Here’s what surprises most developers: this workflow treats documentation not as a deliverable to check off, but as a quality assurance tool. You stress-test it the way you’d stress-test a bridge — apply pressure until something bends or breaks.
When your docs survive scrutiny, you’ve got solid ground to build on. When they don’t, you catch the gaps before they become bugs that haunt your production environment at 2 AM. I’ve found that teams using this approach naturally write clearer specs because they know someone — possibly themselves — will have to answer hard questions later.
The Interview Process Demystified
The beauty is in the systematization. You’re not just reading docs; you’re conducting an interview with your requirements. What are the contradictions? Where does it say one thing but imply another? Which paths through the system haven’t been spelled out at all?
Sound familiar? It’s basically investigative journalism applied to your ticket queue.
The result: no requirement slips through simply because no one thought to ask. That’s not just a workflow improvement — it’s a fundamental shift in how you approach building software.
How ‘Ask Matt’ Transforms Your Development Loop
I’ve spent too many hours asking ChatGPT questions only to receive confident-sounding but completely wrong answers about my codebase. That’s the gap Ask Matt is designed to fill.
From Chatbot to Development Partner
Ask Matt isn’t just a better interface—it’s a structured query system built around how development actually works. Most AI assistants are conversational generalists that hallucinate or serve up outdated information. Ask Matt pulls from the actual skills repository, so when you ask about implementation patterns or requirement clarifications, you’re working with verified context.
This is the part that surprised me: it acts less like a chatbot and more like a colleague who actually read the documentation. You can query during requirements clarification, implementation planning, or debugging that gnarly interaction bug that appeared out of nowhere.
What I appreciate is how the interface encourages precise questioning. When you’re forced to articulate your problem clearly enough for a structured system, you often solve it yourself. Ask Matt becomes a thinking tool, not just an answer machine.
Practical Query Patterns
The CLI integration matters more than it might seem. Instead of switching contexts—opening a browser, pasting code, losing your terminal state—Ask Matt fits into your existing workflow. You’re already in the command line running tests and git commands. Now you can ask context-aware questions without breaking focus.
Key difference: generic AI gives you plausible-sounding guesses. Ask Matt gives you answers grounded in your actual codebase and the skills repository that 170,000 developers have validated.
Sound familiar? It’s the difference between a GPS that makes things up and one that actually knows the route.
The Complete Pipeline: From Spec to Implementation
I’ve noticed that most development workflows treat each phase as its own island—specs here, tickets there, code somewhere else entirely. What Matt Pocock’s approach builds is a conveyor belt where nothing moves forward until quality checks pass. The result is a pipeline that actually feels connected.
Ticket Management Reimagined
Here’s what caught my attention: tickets don’t start with a developer guessing what to build. They’re AI-generated from validated specifications, meaning your documentation review actually means something. By the time a ticket appears, it’s already been vetted against the spec through that “Grill with Docs” interview process.
This shifts tickets from wish lists to implementation blueprints. Sound familiar? That reframe alone changes how a team operates. Instead of spending half your sprint re-interpreting what someone meant, you’re executing already-validated requirements.
In my experience, this is where most workflows fall apart—they treat documentation as ceremonial rather than functional.
TypeScript-Focused Implementation Patterns
The TypeScript-first approach isn’t a preference here; it’s a foundational constraint that shapes how AI generates code. When type safety comes first, entire categories of bugs simply can’t exist at runtime. It’s like having a spell-checker that runs before you finish the sentence, not after.
What surprised me was how this transforms code review. The AI doesn’t replace your judgment—it surfaces deviations from the spec and potential issues, but you still decide. Every suggestion passes through human review before becoming part of the codebase. This maintains accountability without creating busywork.
The 170,000-star Skills repository demonstrates this at scale: systematic, repeatable patterns where AI assistance enhances rather than replaces developer oversight.
Building Your Own AI Development Workflow
Adapting the Methodology to Your Stack
Here’s what took me a while to realize: you don’t need to clone the entire skills repository to benefit from this methodology. The principles transfer to any project, regardless of whether you’re building a React app, a Python backend, or a Rust CLI tool.
The real shift starts with documentation. Think of it like a GPS that recalculates when you take a wrong turn—if your requirements can’t survive three tough questions from a skeptical teammate, they need refinement. This “grill with docs” approach means you’re not just writing documentation; you’re stress-testing it.
Once you’ve got solid docs, the next piece is defining boundaries for your AI interactions. What’s worth querying AI versus what you’ll handle manually? The Ask Matt-style interface works because it has clear constraints. I’ve found that setting these limits early prevents the “is this actually right?” spiral that derails productivity.
Tools and Setup Essentials
The workflow scales from solo projects to full engineering teams. When you’re flying solo, you might keep documentation lighter and iterate faster. Add teammates, and you need more formalized ticket processes and shared conventions.
A CLI that feels natural makes AI interaction a regular part of your dev routine rather than a bolted-on afterthought. That’s the key enabler—if reaching for AI assistance feels clunky, you won’t do it consistently.
One thing worth noting: the open-source nature means you’re not locked into someone else’s vision. If something doesn’t fit your workflow, you can adapt it. And if you build something useful, contributing it back creates a virtuous cycle. Sound familiar? That’s how good tooling evolves.
Frequently Asked Questions
What is the AI coding workflow used by the Skills open-source repository?
The Skills repo uses a structured pipeline that starts with documentation—specifically the ‘Grill with Docs’ approach—where you interview existing docs before writing any code. From there, you generate specs, create tickets, and use AI to implement following those specs. What I’ve found is that this creates a feedback loop where documentation stays accurate because it guides implementation rather than being written after the fact.
How does ‘Grill with Docs’ work as a documentation-first development approach?
It’s essentially an interview process where you question your existing documentation like it was a requirements document. You ask things like ‘Does this function actually do what the docs claim?’ and ‘Are there edge cases missing?’ If you’ve ever wasted time building features based on outdated docs, you’ll see why this step catches so many problems early. The 170,000-star Skills repo demonstrates this by treating documentation as the source of truth that drives code generation.
How can I use AI for the entire development lifecycle from spec to production code?
The pipeline works sequentially: you start with ‘Grill with Docs’ to validate requirements, then write a technical spec, convert that into tickets, and use AI to generate code matching the spec. Finally, you use AI-assisted code review to validate the output. In my experience, the key is that each stage feeds the next—your spec isn’t just prose, it’s the exact blueprint your AI tool should follow when generating code.
What makes Matt Pocock’s AI development methodology different from using ChatGPT for coding?
The big difference is structure. Most people use ChatGPT reactively—stuck on a bug, need a snippet. Matt’s approach is proactive and systematic: you establish documentation standards first, then let AI work within those guardrails. If you’ve ever gotten plausible-sounding but completely wrong code from an AI, it’s usually because there was no spec to validate against. This methodology treats AI as a pipeline participant, not a chatbot you query randomly.
How do you implement documentation-driven development with AI assistants?
Start by writing your docs as if the feature already exists—describe the API, the behavior, the edge cases. Then use that documentation as your prompt input when generating code. What I’ve found is that this flips the typical workflow: instead of ‘write code, then document it,’ you’re ‘document the contract, then generate code that fulfills it.’ The Skills repo CLI even has built-in support for this, making it a first-class workflow rather than an afterthought.
📚 Related Articles
Clone the Skills repository, spend an hour with the Grill with Docs process on your current project, and you’ll immediately see which requirements you assumed were clear but actually need more precision.
Subscribe to Fix AI Tools for weekly AI & tech insights.
Onur
AI Content Strategist & Tech Writer
Covers AI, machine learning, and enterprise technology trends.