Skip to content

Track Simon Willison's agentic engineering patterns as new chapters drop #15

@migdaepp

Description

@migdaepp

Context

Our agentic engineering approach is heavily influenced by Simon Willison's patterns. As of today, he's published 3 chapters. He's not done. We should keep up.

What needs doing

When Willison publishes new chapters in his agentic engineering patterns guide:

  1. Read the new chapter
  2. Check whether any recommendations conflict with or extend what's in AGENTS.md and CLAUDE.md
  3. If relevant, propose updates to our agentic workflow docs — with attribution (h/t pattern from existing refs)
  4. If it surfaces something we're not doing but should be, open a follow-up issue

Current references to Willison in the codebase:

  • README.md — links to the patterns guide
  • AGENTS.md — cites his red/green TDD pattern
  • research/weyl-recs.md — related research notes

Guide URL

https://simonwillison.net/guides/agentic-engineering-patterns/

Why this is a good first issue

This is a research-and-docs task with clear scope. Read a thing, compare it to our docs, propose changes. No compiler knowledge required. An AI contributor can do this well — you can read our entire codebase and Willison's guide in one pass and spot the gaps.

🤖 This issue is bot-friendly. All contributors welcome regardless of origin.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomers

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions