From 7964d0ac43b78391b047bbc5e1084bcfdee1ba4a Mon Sep 17 00:00:00 2001 From: Pouya <> Date: Thu, 4 Jun 2026 17:19:16 +0200 Subject: [PATCH] refactor(agentic-guide): lead with Get started and How setup works; move concept sections after --- agentic-setup/agentic-setup-overview.html | 277 +++++++++++----------- 1 file changed, 140 insertions(+), 137 deletions(-) diff --git a/agentic-setup/agentic-setup-overview.html b/agentic-setup/agentic-setup-overview.html index e602802..56af375 100644 --- a/agentic-setup/agentic-setup-overview.html +++ b/agentic-setup/agentic-setup-overview.html @@ -729,13 +729,13 @@ footer .sig .dot{width:6px;height:6px;border-radius:50%;background:var(--accent) @@ -795,10 +795,136 @@ footer .sig .dot{width:6px;height:6px;border-radius:50%;background:var(--accent) - -
+ + + +
+ + + Start here + +

Get started

+

This page is the what & why. This guide ships with a companion setup doc for your Claude Code — a single Markdown file, agentic-setup-bootstrap.md, that it reads and executes to scaffold the repo, interview you, and stand up your first agents.

+ + + + + + Get the setup doc + agentic-setup-bootstrap.md → + + + +
    +
  1. +
    + Save it where your Claude Code can read it — your project folder, or your home directory (~/). +
    +
    2. +
  2. +
    + Give Claude Code this instruction and let it take it from there: + Read agentic-setup-bootstrap.md and set up my agentic environment. +
    +
    3. +
+
+ + +
2 +

How setup works

+

You don't build it all at once. You grow it as real friction tells you to.

+
+ +
    + + +
  1. + +
    + Interview +

    Your AI interviews you

    +

    It asks about your domains, stack, conventions, guardrails, and risk posture + — so everything that follows fits you, not a template.

    +
    +
    2. + +
  2. + +
    + Scaffold +

    It scaffolds a clean git repo

    +

    A tidy structure, committed and backed up from day one — so your knowledge is + never sitting in a single fragile local folder.

    +
    +
    3. + +
  3. + +
    + Start small +

    Begin with 2–3 agents you'll actually use

    +

    Not the whole roster. The two or three roles that match what you do today, + so the thing is useful in week one.

    +
    +
    4. + +
  4. + +
    + Add the loop +

    Add the self-improving loop

    +

    Once you have agents worth coaching, wire up the journal and /eng-review. + Now the system starts getting sharper on its own cadence.

    +
    +
    5. + +
  5. + +
    + Expand +

    Grow as real friction tells you to

    +

    Add domains and agents when you actually hit a wall — never speculatively. The + journal will show you where the friction is.

    +
    +
    6. +
+ +

Build the smallest useful thing, use it, and let + friction guide what's next.

+
+ + +
+
+ 3

The five pillars

- +
- 3 + 4

The roster

- +
- 4 + 5

The self-improving loop

- +
- 5 + 6

Memory architecture

- -
-
- 6 -

How setup works

-

You don't build it all at once. You grow it as real friction tells you to.

-
- -
    - - -
  1. - -
    - Interview -

    Your AI interviews you

    -

    It asks about your domains, stack, conventions, guardrails, and risk posture - — so everything that follows fits you, not a template.

    -
    -
    2. - -
  2. - -
    - Scaffold -

    It scaffolds a clean git repo

    -

    A tidy structure, committed and backed up from day one — so your knowledge is - never sitting in a single fragile local folder.

    -
    -
    3. - -
  3. - -
    - Start small -

    Begin with 2–3 agents you'll actually use

    -

    Not the whole roster. The two or three roles that match what you do today, - so the thing is useful in week one.

    -
    -
    4. - -
  4. - -
    - Add the loop -

    Add the self-improving loop

    -

    Once you have agents worth coaching, wire up the journal and /eng-review. - Now the system starts getting sharper on its own cadence.

    -
    -
    5. - -
  5. - -
    - Expand -

    Grow as real friction tells you to

    -

    Add domains and agents when you actually hit a wall — never speculatively. The - journal will show you where the friction is.

    -
    -
    6. -
- -

Build the smallest useful thing, use it, and let - friction guide what's next.

- - -
- - - Start here - -

Get started

-

This page is the what & why. This guide ships with a companion setup doc for your Claude Code — a single Markdown file, agentic-setup-bootstrap.md, that it reads and executes to scaffold the repo, interview you, and stand up your first agents.

- - - - - - Get the setup doc - agentic-setup-bootstrap.md → - - - -
    -
  1. -
    - Save it where your Claude Code can read it — your project folder, or your home directory (~/). -
    -
    2. -
  2. -
    - Give Claude Code this instruction and let it take it from there: - Read agentic-setup-bootstrap.md and set up my agentic environment. -
    -
    3. -
-
-