The Pottery Era of Software - When Your 20-Line Skill File Grows to 600+

Fazm Team··2 min read

The Pottery Era of Software

Someone recently described their skill file journey: it started as 20 lines of instructions and grew to 600+ lines of hand-tuned behavior. That's not scope creep. That's craft.

Software as Clay

The pottery metaphor is perfect for what's happening with AI agent configuration. You don't design a pot on paper and manufacture it. You sit at the wheel, shape it, fire it, see where it cracks, reshape, and fire again.

Skill files work the same way. You start with a rough outline - "run my tests, commit the results." Then you notice the agent keeps forgetting to stage specific files. So you add a line. Then it formats commit messages wrong. Another line. Then it runs the wrong test suite on Fridays when the staging server is down. Three more lines.

Why 600 Lines Isn't Too Many

Every line in a mature skill file represents a lesson learned. Line 347 exists because one Tuesday the agent deleted a migration file. Line 512 exists because it kept using the wrong API key for production deploys.

These aren't abstract specifications. They're battle scars turned into instructions. Each one prevents a specific failure mode that actually happened.

The Craft Is in the Iteration

Traditional software development treats specs as something you write once and implement. The pottery era flips this. Your spec is a living document that evolves through daily use. The "code" is the instructions themselves.

This changes who can build software. You don't need to know Swift or Python. You need to know your workflow deeply enough to describe it precisely. Domain expertise becomes the primary skill, not programming language fluency.

What This Means for Tools

The best AI agent tools will be the ones that make skill file iteration fast. Version history, diff views, A/B testing different instruction sets, and rollback when something breaks. The development environment for the pottery era isn't an IDE - it's a skill editor with good undo.

More on This Topic

Fazm is an open source macOS AI agent. Open source on GitHub.

Related Posts