Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 18 additions & 23 deletions .github/workflows/deploy-pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,10 @@ name: Deploy GitHub Pages

on:
push:
branches: [main]
branches: [main, go-to-market]
paths:
- 'book/**'
- 'assets/**'
- 'diagrams/**'
- 'scripts/generate-toc.sh'
- 'scripts/validate-links.sh'
- 'website/**'
- '.github/workflows/deploy-pages.yml'
workflow_dispatch:

permissions:
Expand All @@ -31,37 +28,35 @@ jobs:
with:
fetch-depth: 0

- name: Setup pnpm
uses: pnpm/action-setup@v4
with:
version: 9

- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm'
cache: 'pnpm'
cache-dependency-path: 'website/pnpm-lock.yaml'

- name: Install dependencies
run: npm ci

# TODO: Fix markdown-link-check ESM dependency issue
# - name: Validate internal links
# run: ./scripts/validate-links.sh
# env:
# CHECK_EXTERNAL: false
working-directory: ./website
run: pnpm install --frozen-lockfile

- name: Generate table of contents
run: ./scripts/generate-toc.sh
- name: Build Next.js site
working-directory: ./website
run: pnpm build
env:
NEXT_PUBLIC_BASE_PATH: /agentic-coding-book

- name: Configure GitHub Pages
uses: actions/configure-pages@v4

- name: Build Jekyll site
uses: actions/jekyll-build-pages@v1
with:
source: ./book
destination: ./_site

- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: ./_site
path: ./website/out

- name: Deploy to GitHub Pages
id: deployment
Expand Down
20 changes: 13 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# The Agentic Coding Playbook: From Idea to Production in 6 Weeks

[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)
[![Status: In Development](https://img.shields.io/badge/status-in%20development-yellow.svg)]()
[![Status: Part 1 Published](https://img.shields.io/badge/status-part%201%20published-green.svg)]()
[![Deploy Pages](https://github.com/testaco/agentic-coding-book/actions/workflows/deploy-pages.yml/badge.svg)](https://github.com/testaco/agentic-coding-book/actions/workflows/deploy-pages.yml)
[![Build PDF](https://github.com/testaco/agentic-coding-book/actions/workflows/build-pdf.yml/badge.svg)](https://github.com/testaco/agentic-coding-book/actions/workflows/build-pdf.yml)
[![Validate](https://github.com/testaco/agentic-coding-book/actions/workflows/validate.yml/badge.svg)](https://github.com/testaco/agentic-coding-book/actions/workflows/validate.yml)
Expand Down Expand Up @@ -51,11 +51,17 @@ If you want to ship software products faster using AI assistance, this book is f

## Development Status

**Current Milestone:** MVP (Week 2) - Infrastructure setup and Part 1: Foundations
**🎉 Part 1: Foundations is now published!** All five foundational chapters are complete and ready to read.

**Current Status:**
- ✅ Part 1: Foundations - Published (5 chapters, ~70K words)
- 🚧 Part 2: The Playbook - In development
- 📋 Part 3: Patterns & Tools - Planned
- 📋 Part 4: Complete Example - Planned

**Upcoming Milestones:**
- Week 6: v1.0 - Complete first pass of all 4 parts
- Week 12: v1.1 - Refinements, advanced patterns, print-ready
- Q2 2026: Part 2 (The Playbook) release
- Q3 2026: Parts 3-4 and v1.0 complete edition

See [`planning/roadmap.md`](planning/roadmap.md) for detailed timeline and [`CHANGELOG.md`](CHANGELOG.md) for version history.

Expand Down Expand Up @@ -215,7 +221,7 @@ See the [LICENSE](LICENSE) file for the complete legal text.

## Author

[Author information - TBD]
**Chris Testa** - CTO and engineering leader with decades of experience shipping products at scale. Now teaching others to build software products in the age of AI.

## Acknowledgments

Expand All @@ -225,6 +231,6 @@ Special thanks to the Claude Code team at Anthropic for creating tools that make

---

**Status:** 🚧 **In Development** - Infrastructure setup complete, Part 1 content in progress
**Status:** **Part 1 Published** - Infrastructure complete, Part 1: Foundations published, Parts 2-4 in development

**Next Milestone:** Week 2 MVP with Part 1: Foundations complete
**Next Milestone:** Part 2: The Playbook (Q2 2026)
20 changes: 2 additions & 18 deletions book/_data/navigation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,21 +21,5 @@ parts:
url: "/part1-foundations/03-architecture-principles/01-introduction"
- title: "4. Digestible Interfaces"
url: "/part1-foundations/04-digestible-interfaces/01-introduction"

- title: "Part 2: The Playbook"
url: "/part2-playbook/"
chapters:
- title: "3. Brainstorm to Brief"
url: "/part2-playbook/03-brainstorm-to-brief"

- title: "Part 3: Patterns & Tools"
url: "/part3-patterns-tools/"
chapters:
- title: "1. EARS Notation"
url: "/part3-patterns-tools/specifications/ears-notation"

- title: "Part 4: Complete Example"
url: "/part4-example/"
chapters:
- title: "5. Implementing the MVP"
url: "/part4-example/05-implementing-mvp"
- title: "5. New Bottlenecks"
url: "/part1-foundations/05-new-bottlenecks/01-introduction"
22 changes: 11 additions & 11 deletions book/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ part: 0
chapter: 0
version: "1.0"
date: "2025-12-28"
status: "draft"
author: "Author Name"
status: "published"
author: "Chris Testa"
tags: ["introduction", "overview", "agentic-coding"]
related:
- preface.md
Expand Down Expand Up @@ -232,17 +232,17 @@ Under the following terms:

## Status

This book is currently **in active development**.
**Part 1: Foundations is now published!** Parts 2-4 are in active development.

| Component | Status |
| ------------------------ | ------------------------ |
| Part 1: Foundations | Draft chapters available |
| Part 2: The Playbook | In progress |
| Part 3: Patterns & Tools | Partial coverage |
| Part 4: Complete Example | Planned |
| Infrastructure | Complete |
| Component | Status |
| ------------------------ | ----------- |
| Part 1: Foundations | ✅ Published |
| Part 2: The Playbook | In progress |
| Part 3: Patterns & Tools | Planned |
| Part 4: Complete Example | Planned |
| Infrastructure | Complete |

Watch the repository or check back for updates.
[Watch the repository](https://github.com/testaco/agentic-coding-book) to get notified when Parts 2-4 are released.

---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 1
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 2
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 3
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 4
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 5
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 6
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 7
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 8
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
4 changes: 2 additions & 2 deletions book/part1-foundations/01-renaissance-developer/09-summary.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 9
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 1
section: 10
version: '0.1'
date: '2025-12-24'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- renaissance-developer
- mindset
Expand All @@ -25,18 +25,18 @@ abstract: Section 10 of The Renaissance Developer

**Continue the foundations**:

- **Chapter 2: What Is Agentic Coding?** - [Placeholder: Deep dive into the mechanics of AI-assisted development: tools, agents, workflows, and how they work together]
- **Chapter 3: Architecture Principles for Agentic Development** - [Placeholder: How system design changes when AI handles implementation]
- **Chapter 4: Digestible Interfaces** - [Placeholder: Why clear boundaries and contracts matter for both humans and AI]
- **Chapter 2: What Is Agentic Coding?** - Explore the full spectrum of AI-assisted development: from autocomplete to autonomous agents. Understand the tools, capabilities, and workflows that enable Renaissance Developers to move fast without sacrificing quality.
- **Chapter 3: Architecture Principles for Agentic Development** - Learn how system architecture evolves when AI handles implementation. Discover why modularity, interface contracts, and clear boundaries become even more critical in an AI-accelerated workflow.
- **Chapter 4: Digestible Interfaces** - Master the art of designing interfaces that work for both human reviewers and AI implementers. Learn why the same principles that make code human-readable also make it AI-processable.

**Apply the concepts**:

- **Part 2: The Playbook** - [Placeholder: The complete 6-week journey from idea to production, starting with transforming your idea into a clear vision]
- **Chapter 6: Requirements Writing with EARS** - [Placeholder: Learn to write specifications that AI can implement accurately]
- **Part 2: The Playbook** - Follow the complete 6-week journey from initial idea to production deployment. Get a step-by-step guide to each phase: ideation, brainstorming, requirements, design, implementation, and launch. See the Renaissance Developer model in action.
- **Part 2: Requirements and Specifications** - Master the art of writing specifications that AI can implement accurately. Learn EARS notation, API contracts, and structured requirements that eliminate ambiguity and accelerate development.

**Pattern reference**:

- **Part 3: Patterns & Tools** - [Placeholder: Reference material for specific techniques, architectural patterns, and tool deep-dives]
- **Part 3: Patterns & Tools** - Deep-dive reference on architecture patterns, specification formats, testing strategies, and toolchain optimization. Return here when you need detailed guidance on specific techniques, from bounded contexts to MCP servers to test pyramids.

### External Resources

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 2
section: 1
version: '0.1'
date: '2026-01-28'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- agentic-coding
- definitions
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 2
section: 2
version: '0.1'
date: '2026-01-28'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- agentic-coding
- definitions
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 2
section: 3
version: '0.1'
date: '2026-01-28'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- agentic-coding
- definitions
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 2
section: 4
version: '0.1'
date: '2026-01-28'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- agentic-coding
- definitions
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 2
section: 5
version: '0.1'
date: '2026-01-28'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- agentic-coding
- definitions
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 2
section: 6
version: '0.1'
date: '2026-01-28'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- agentic-coding
- definitions
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ chapter: 2
section: 7
version: '0.1'
date: '2026-01-28'
status: draft
author: Author Name
status: published
author: Chris Testa
tags:
- agentic-coding
- definitions
Expand Down
Loading
Loading