section-pass — one agent per section, the details put in

When I ran the overnight build system using section-pass, I realized just how critical this tool is for refining long pages. The tool's genius lies in its methodical approach: after you've got your draft, you go back in with a laser-focus on each section. This involves assigning one agent per section, each armed with a fixed question set and an exhaustive proof inventory.

Here's how it played out. First, I assembled the necessary inputs before spawning any agents. I exported the page as text, sectioned it appropriately — in this case, using the markdown export /brand-pass/deep/<slug>/report.md for a DeepReport page. This gave me a clear structure to feed into the system.

The next step was identifying the reader. Rather than thinking in terms of demographics, I nailed down one specific individual: what they value, what they asked for, and what they will check first. This level of specificity is crucial, and it was documented as part of the input process.

The proof inventory was a beast, but an essential one. Each item had to be logged — its purpose, honest assessment, and, critically, a public link. This inventory was extensive, drawing from various sources like ProductOS/AppsOS/APP-PORTFOLIO-BOARD.md for apps, and the Live Integrations table in CLAUDE.md. Anything without a public link was off-limits for claims, ensuring accountability and transparency.

I then defined the rules for the page, which included avoiding certain claims or jargon the reader doesn’t use. These rules were guided by PITCH-PAGE-PRINCIPLES.md in docs/features/brand-pass/, which helped maintain consistency.

Now for the pass itself. One agent was spawned per section, each working in parallel yet blind to the others. This ensured focused rewrites without cross-contamination. Each agent received its section’s text, the entire page for context, the reader profile, the proof inventory, and the set questions.

One section came under scrutiny when the agent determined its purpose was merely "transition". It was flagged as a candidate for removal, highlighting how section-pass can trim the fat. Another agent identified a missing piece that the reader wanted, which was cross-referenced with the reader's profile to ensure relevance.

By morning, the page was leaner, more precise, and densely packed with value. The overnight run of section-pass transformed what was a sprawling draft into a tight, reader-focused narrative. If you're building an autonomous business and need your pages to speak directly to a specific audience, section-pass is an indispensable tool for that second, crucial pass.