L8 Principal's Agentic Engineering Workflow
L8 Principal's Agentic Engineering Workflow — Detailed Summary
-
Core Mindset & Shift to "Captain / Engineering Director"
- Role Transition: Stop acting like a line-by-line developer manually reviewing code diffs, which creates a personal velocity bottleneck. Instead, operate as an Engineering Director/Captain—setting direction, maintaining quality bars, and managing AI agent crewmates.
- High Velocity Output: Ships 40–50 fully tested, production-ready PRs per day (rather than simple "vibe-coding" demos) by focusing on high-level planning upfront and automated quality validation at the end.
- Correcting AI Biases: Frontier models naturally overestimate human development time (e.g., estimating days/weeks for a project an agent can build in minutes) because they are trained on human data. Global instructions must explicitly instruct agents not to over-weight development cost in technical decision-making, preventing them from picking low-quality, cheap shortcuts.
- Bug Reproduction Protocol: Forces agents to reproduce bugs end-to-end (E2E) as a real user would experience them before attempting a fix, rather than relying solely on superficial unit tests.
-
Terminal-Centric Flow State
- Hands-on-Keyboard Discipline: Doing work in the terminal eliminates mouse interaction, preventing context-switching and preserving flow state.
- Cross-Device Consistency: Allows the exact same development workflow and persistent session setup to run across Mac, Windows, Linux, laptops, and mobile phones.
-
Agent Onboarding & Knowledge Architecture
- Memory Hierarchy:
- Global Memory (
~/.claude/CLAUDE.md/~/.config/agents/agents.md): Minimal (~27 lines) cross-project personal preferences loaded into every system prompt. Kept strictly concise to avoid unnecessary token burn. - Project Memory (
CLAUDE.md/agents.md): Captures repository architecture, domain terminology, testing setups, and collective learnings from past errors. - Symlinking Strategy: Uses symbolic links to point harness-specific memory files (
CLAUDE.md) to generic agent configuration files (agents.md), keeping the setup agent-agnostic.
- Global Memory (
- Skills via Progressive Disclosure: Moves conditionally useful instructions (e.g., E2E testing setups) out of memory files into modular skill files. Skills only load a tiny description field into the initial system prompt, fetching full instructions only when invoked.
- Skill Benchmark Warning: Warns against blindly installing popular internet skills (e.g., highly-starred repositories). Benchmarking shows unverified skills can increase token consumption by 5%+ and degrade task success rates while introducing security/credential risks.
- Memory Hierarchy:
-
Prompting, Tooling & Agent Ergonomics
- Voice-First Input: Uses local voice transcription (3x faster than typing) for complex prompts, reserving manual typing strictly for exact file paths and URLs.
- Agent Ergonomics (AXI Standard): Replaces standard MCP (Model Context Protocol) servers with specialized CLI tools and design standards optimized for agents. Benchmarks demonstrate that GitHub MCP servers can cost 3x more tokens and double latency compared to CLI-based interfaces.
-
Execution, Planning & Automated Quality Assurance
- Visual Planning (Lavish): Replaces dense terminal text walls during project planning by spinning up interactive, HTML/artifact-based design systems directly in the browser to visualize choices, annotate UI feedback, and log decisions.
- Adversarial Post-Processing (No Mistakes): Orchestrates an isolated Git worktree pipeline that rebases code on
main, resolves merge conflicts, runs an adversarial agent review in a clean context window, executes E2E validation while logging visual evidence (screenshots/video/logs), updates documentation, and babysits the PR through CI/CD merge. - Overnight Autonomous Loops (Good Night Have Fun): Runs long-horizon, iterative tasks (e.g., E2E usability testing, test coverage improvement, metric optimization) under precise iteration caps, token limits, and strict stopping conditions without risking quota burn.
-
Multi-Agent Scale & First Mate Orchestration
- Workspace Isolation (Treehouse): Eliminates manual Git worktree creation overhead (
git worktree add/remove) by dynamically provisioning and reusing isolated worktree directories for concurrent agent sessions. - First Mate Orchestration: Uses a top-level managerial "First Mate" agent to parse complex, multi-repository prompts, break them down into sub-tasks, delegate them across background agent sessions in parallel worktrees, and coordinate issue triaging.
- Workspace Isolation (Treehouse): Eliminates manual Git worktree creation overhead (
Dedicated Tools & Software Stack
-
Terminal Emulator & Shell Setup
- WezTerm: High-performance, cross-platform (Mac/Windows/Linux) terminal emulator fully configured dynamically via Lua scripts (
wezterm.lua). - tmux: Terminal multiplexer used to manage multi-pane layouts and background tabs for parallel agent sessions; preserves session state across device connections.
- WezTerm: High-performance, cross-platform (Mac/Windows/Linux) terminal emulator fully configured dynamically via Lua scripts (
-
Code Editor & Voice Inputs
- Neovim: Modal, keyboard-driven text editor optimized with plugins for fast fuzzy file finding, code searching (
ripgrep), and precise navigation. - Open Superwhisper: Free, open-source local voice-to-text application running OpenAI Whisper locally on-device. Uses custom initial prompts to recognize technical vocabulary, URLs, and project names cleanly.
- Neovim: Modal, keyboard-driven text editor optimized with plugins for fast fuzzy file finding, code searching (
-
Agent Harnesses
- Claude Code: Primary agent harness used in the demonstration; noted for out-of-the-box defaults and feature richness.
- Codeex CLI: Open-source, Rust-based fast CLI agent harness capable of inspecting its own source code for self-debugging.
- Pi Coding Agent: Minimalist, highly extensible coding agent harness focused on customization.
- Open Code: Model-agnostic agent harness featuring a smooth Terminal User Interface (TUI) and multi-model integrations.
- Vercel Skills CLI (
npx skills): Command-line tool used to search, install, and manage agent skills across various agent harnesses.
-
Author's Open-Source Agent Ecosystem
- AXI Standard (
axi.md): Agent Ergonomics design standards and optimized CLI tooling catalog (e.g., GitHub AXI, Chrome DevTools AXI) designed to minimize token usage and latency. - Lavish AXI: Visual artifact and interactive HTML planning editor that replaces text walls in the terminal with rich UI components for concept review and annotation.
- No Mistakes: Automated CI/PR pipeline that handles isolated worktree rebasing, adversarial code reviews, E2E evidence capture (screenshots/video), doc updates, and PR babysitting.
- Good Night Have Fun: Autonomous long-running loop runner with customizable token caps, iteration limits, and stop conditions for overnight or heavy iterative work.
- Treehouse: Automatic Git worktree manager that manages dynamic, reusable workspace directories for parallel agent sessions.
- First Mate: Managerial meta-agent that accepts high-level natural language instructions, spawns sub-agents across isolated worktrees, and manages multi-task orchestration automatically.
- AXI Standard (