You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is an mdBook documentation project - "The Agentic Systems Series" - a comprehensive two-book guide about building AI coding assistants. It analyzes architecture patterns from Claude Code, anon-kode, and Amp to provide practical insights for engineers building production AI development tools.
16
8
17
-
## Navigation
18
-
- Ensure chapters flow logically from introduction to advanced topics
19
-
- Include navigation links at bottom of pages where appropriate
20
-
- Maintain table of contents for easy reference
9
+
The series covers everything from single-user local tools (Book 1) to collaborative enterprise platforms (Book 2).
21
10
22
-
## Writing Style
11
+
## Common Commands
12
+
13
+
```bash
14
+
# Local development
15
+
mdbook serve # Start local server at http://localhost:3000
16
+
mdbook build # Build static site to book/ directory
17
+
mdbook clean # Clean build artifacts
18
+
19
+
# Testing
20
+
mdbook test# Test code examples in documentation
21
+
```
22
+
23
+
## Project Structure
24
+
25
+
The documentation follows mdBook conventions:
26
+
-`src/` - All markdown content files
27
+
-`src/SUMMARY.md` - Navigation structure and chapter ordering
28
+
-`book.toml` - mdBook configuration
29
+
-`amp/` - Contains analyzed source code from amp/Claude Code
30
+
-`src/second-edition/` - Book 2: Amping Up an Agentic System
-**Book 2**: Collaborative architecture, enterprise features, scaling patterns, production deployment
35
+
36
+
## Writing Guidelines
37
+
38
+
### Style
23
39
- Technical but relaxed: Clear explanations without formal language, avoiding buzzwords or unnecessary complexity
24
40
- Concise and direct: Minimal filler or extra detail; each sentence contributes meaningfully
25
41
- Casual yet authoritative: Written as a peer talking to other engineers—approachable but clearly knowledgeable
@@ -28,10 +44,30 @@ This repository contains documentation about Claude Code's architecture being st
28
44
- IRC-inspired pragmatism: Direct and practical, straightforward phrasing reminiscent of a developer chat rather than corporate communication
29
45
- Varied article usage: Diverse use of articles ("a", "the", "this", etc.) rather than repetitive patterns
30
46
31
-
## Hard Rules
47
+
###Hard Rules
32
48
-**NO speculation**: Only document what's observable in the code. Never speculate about intentions, roadmaps, or development status.
33
49
-**NO prescriptive language**: Avoid "should", "must", "need to", "have to" when giving recommendations. Use "consider" or simply state options directly.
34
50
-**NO obvious details**: Skip mentioning basic implementation details like UTF-8 encoding or standard language features that any developer would expect.
35
51
-**NO LLM-like language**: Avoid flowery or overly formal descriptions. Write like a programmer talking to another programmer.
36
52
-**NO weasel words**: Avoid hedging language like "perhaps", "seems to", "appears to", "might be", "this approach", "this pattern", "this system", unless truly uncertain. Be direct and assertive.
37
-
-**Facts only**: Base all technical documentation on direct code evidence, not assumptions.
53
+
-**Facts only**: Base all technical documentation on direct code evidence, not assumptions.
54
+
55
+
## Architecture Notes
56
+
57
+
The series analyzes real implementations from multiple systems:
58
+
59
+
**Book 1 (Claude Code/anon-kode patterns):**
60
+
- Reactive UI built with Ink and Yoga for terminal interfaces
61
+
- Parallel tool execution for performance
62
+
- Permission system for safe operations
63
+
- Extensible tool architecture with standardized interfaces
64
+
- Command system with slash commands and contextual help
65
+
66
+
**Book 2 (Amp collaborative patterns):**
67
+
- Conversation management and state synchronization
68
+
- Enterprise authentication and identity management
69
+
- Real-time collaboration and team workflows
70
+
- Multi-agent orchestration and performance optimization
71
+
- Production deployment and scaling strategies
72
+
73
+
When documenting architecture patterns, reference actual source files in `amp/core/src/` for concrete examples, but generalize proprietary implementation details into reusable patterns.
Copy file name to clipboardExpand all lines: README.md
+23-40Lines changed: 23 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,55 +1,38 @@
1
-
# Building an Agentic System
1
+
# The Agentic Systems Series
2
2
3
-
A deep-dive guide into architecture patterns for building responsive, reliable AI coding agents.
3
+
A comprehensive guide to building production-ready AI coding assistants, from local tools to enterprise platforms.
4
4
5
-
## About This Book
5
+
## Overview
6
6
7
-
This guide explores practical architecture patterns for real-time AI coding assistants, derived from an analysis of Claude Code, anon-kode, and other systems. It focuses on:
7
+
This two-book series provides practical engineering patterns for building AI coding assistants based on analysis of real production systems including Claude Code, Amp, and open-source implementations.
8
8
9
-
- Responsive user interfaces with streaming responses
10
-
- Parallel tool execution for performance
11
-
- Permission systems for safety
12
-
- Extensible tool architecture
9
+
**Book 1: Building an Agentic System**
10
+
- Core architecture patterns for AI coding assistants
11
+
- Reactive terminal UIs with streaming responses
12
+
- Tool systems and permission models
13
+
- Parallel execution strategies
13
14
14
-
Written for software engineers building their own AI agents who want practical architecture patterns rather than theoretical discussions.
15
+
**Book 2: Amping Up an Agentic System**
16
+
- Scaling from single-user to collaborative platforms
17
+
- Enterprise authentication and team workflows
18
+
- Real-time synchronization patterns
19
+
- Production deployment strategies
20
+
21
+
## For Engineers
22
+
23
+
Written for software engineers building AI-powered development tools, with focus on:
24
+
- Practical patterns over theory
25
+
- Real architectural decisions
26
+
- Production-ready implementations
27
+
- Scalable system design
15
28
16
29
## Read Online
17
30
18
31
Visit [gerred.github.io/building-an-agentic-system](https://gerred.github.io/building-an-agentic-system) for the rendered book.
0 commit comments