Skip to content

Commit c03f757

Browse files
committed
Update documentation Tue Jan 20 06:13:30 UTC 2026
1 parent 588068e commit c03f757

5 files changed

Lines changed: 23 additions & 147 deletions

File tree

-436 KB
Binary file not shown.

images/ai-agents-framework.png

47 KB
Loading

images/ai-agents-workflow.png

107 KB
Loading

search.json

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,18 @@
229229
"href": "team-building/ai-agents.html",
230230
"title": "Integrating AI Agents as Team Members",
231231
"section": "",
232-
"text": "From Copilots to Colleagues\nMost organizations today use AI as a copilot. It answers questions, drafts text, writes code snippets, and accelerates individual productivity. Yet in almost all cases, it remains fundamentally subordinate—invoked on demand, dismissed when inconvenient, and excluded from responsibility.\nThis chapter explores a different organizational pattern: integrating AI agents as team members.\nNot as tools. Not as chatbots. But as entities that hold context, perform ongoing roles, and absorb responsibility within real teams.\nThis is not a story about automation in the abstract. It is a practical method that emerges under specific constraints, introduces real pressures, and reshapes how work happens when speed outgrows structure.\nflowchart TB\n\n %% Phase 1\n subgraph P1[\"1. Constraint ID\"]\n S0[Identify Human Bottleneck]\n end\n\n %% Phase 2\n subgraph P2[\"2. Autonomy Enablement\"]\n S1[Enable Autonomy]\n S1a[Provide Agentic Dev Access]\n S1b[Reduce Engineering Dependency]\n S1 --> S1a\n S1 --> S1b\n end\n\n %% Phase 3\n subgraph P3[\"3. Agent-Supported Work\"]\n S2[Independent Contribution]\n S2a[Locate Existing Components]\n S2b[Adapt and Assemble Functionality]\n S2 --> S2a\n S2 --> S2b\n end\n\n %% Phase 4\n subgraph P4[\"4. Role Externalization\"]\n S4[Product-Oriented Agent]\n S4a[Answer Routine Questions]\n S4b[Async Escalation]\n\n S5[Architecture-Oriented Agent]\n S5a[Review Contributions]\n S5b[Enforce Constraints]\n\n S4 --> S4a\n S4 --> S4b\n S5 --> S5a\n S5 --> S5b\n end\n\n %% Phase 5\n subgraph P5[\"5. Emergent Process\"]\n S6[Process Forms Implicitly]\n end\n\n %% Phase 6\n subgraph P6[\"6. Stable Delivery\"]\n S7[Delivery Cycle]\n S7a[Design]\n S7b[Build]\n S7c[Release]\n S7 --> S7a\n S7 --> S7b\n S7 --> S7c\n end\n\n %% Flow\n P1 --> P2 --> P3 --> P4 --> P5 --> P6\n\n %% Styling\n style P1 fill:#F5F7FA,stroke:#6B7280,stroke-width:1px\n style P2 fill:#E0F2FE,stroke:#0284C7,stroke-width:1px\n style P3 fill:#ECFDF5,stroke:#059669,stroke-width:1px\n style P4 fill:#FFF7ED,stroke:#EA580C,stroke-width:1px\n style P5 fill:#EEF2FF,stroke:#4F46E5,stroke-width:1px\n style P6 fill:#FDF2F8,stroke:#BE185D,stroke-width:1px",
232+
"text": "From Copilots to Colleagues\nMost organizations today use AI as a copilot. It answers questions, drafts text, writes code snippets, and accelerates individual productivity. Yet in almost all cases, it remains fundamentally subordinate—invoked on demand, dismissed when inconvenient, and excluded from responsibility.\nThis chapter explores a different organizational pattern: integrating AI agents as team members.\nNot as tools. Not as chatbots. But as entities that hold context, perform ongoing roles, and absorb responsibility within real teams.\nThis is not a story about automation in the abstract. It is a practical method that emerges under specific constraints, introduces real pressures, and reshapes how work happens when speed outgrows structure.",
233+
"crumbs": [
234+
"Team Building",
235+
"<span class='chapter-number'>7</span>  <span class='chapter-title'>Integrating AI Agents as Team Members</span>"
236+
]
237+
},
238+
{
239+
"objectID": "team-building/ai-agents.html#from-copilots-to-colleagues",
240+
"href": "team-building/ai-agents.html#from-copilots-to-colleagues",
241+
"title": "Integrating AI Agents as Team Members",
242+
"section": "",
243+
"text": "Agent Integration Workflow",
233244
"crumbs": [
234245
"Team Building",
235246
"<span class='chapter-number'>7</span>  <span class='chapter-title'>Integrating AI Agents as Team Members</span>"
@@ -284,7 +295,7 @@
284295
"href": "team-building/ai-agents.html#step-4-let-process-emerge-via-agents",
285296
"title": "Integrating AI Agents as Team Members",
286297
"section": "Step 4: Let Process Emerge via Agents",
287-
"text": "Step 4: Let Process Emerge via Agents\nAs contribution broadens, senior engineers often experience increased review and alignment load. The conventional response would be to introduce formal process: reviews, committees, documentation requirements.\nAn alternative is to let agents absorb this pressure.\nTechnical governance agents can be introduced to:\n\nReview code changes\nEnforce architectural constraints\nMaintain up-to-date knowledge of system-specific limitations\n\nTogether, these agents create something unusual: process without process.\nThere are no new standing meetings. No heavy documentation mandates. No explicit bureaucracy.\nStructure emerges only where it is needed, mediated through agents rather than enforced through hierarchy.\n\n\n\n\n\nflowchart LR\n %% Humans\n H[Humans Design · Product · Sales · Ops]\n\n %% Product (External)\n Maya[Maya Product AI Design Leader – Customer-facing]\n\n %% Internal Framework\n Framework[Agentic Framework Inspired by Maya]\n Mappy[Mappy PM & Orchestration Agent]\n\n %% Inputs\n Sales[Sales Calls & Business Conversations]\n Slack[Slack Threads Async Input]\n\n %% Process Stages\n Ideation[Ideation & Prototyping]\n Design[Design Decisions & Specs]\n Build[Build & Implement]\n Ship[Ship & Launch]\n Test[Test & Observe]\n Learn[Learn & Adapt]\n\n %% Philosophy influence\n Maya -.-&gt;|Design philosophy guided creation, memory, structure| Framework\n\n %% Human interaction\n H --&gt;|Ideas & context| Framework\n Framework --&gt; Ideation\n Ideation --&gt; Design\n\n %% Orchestration\n Design --&gt; Mappy\n Sales --&gt; Mappy\n Slack --&gt; Mappy\n\n %% Mappy responsibilities\n Mappy --&gt;|Backlog & Priorities| Build\n Mappy --&gt;|Design Docs| Build\n Mappy --&gt;|Decision Memory| Build\n\n %% Delivery loop\n Build --&gt; Ship\n Ship --&gt; Test\n Test --&gt; Learn\n\n %% Feedback loops\n Learn --&gt;|Insights| Framework\n Learn --&gt;|Updated priorities| Mappy\n\n %% Async contribution\n H --&gt;|Async input| Slack",
298+
"text": "Step 4: Let Process Emerge via Agents\nAs contribution broadens, senior engineers often experience increased review and alignment load. The conventional response would be to introduce formal process: reviews, committees, documentation requirements.\nAn alternative is to let agents absorb this pressure.\nTechnical governance agents can be introduced to:\n\nReview code changes\nEnforce architectural constraints\nMaintain up-to-date knowledge of system-specific limitations\n\nTogether, these agents create something unusual: process without process.\nThere are no new standing meetings. No heavy documentation mandates. No explicit bureaucracy.\nStructure emerges only where it is needed, mediated through agents rather than enforced through hierarchy.\n\n\n\nAgentic Framework Architecture",
288299
"crumbs": [
289300
"Team Building",
290301
"<span class='chapter-number'>7</span>  <span class='chapter-title'>Integrating AI Agents as Team Members</span>"

team-building/ai-agents.html

Lines changed: 10 additions & 145 deletions
Original file line numberDiff line numberDiff line change
@@ -70,10 +70,6 @@
7070
"search-label": "Search"
7171
}
7272
}</script>
73-
<meta name="mermaid-theme" content="default">
74-
<script src="../site_libs/quarto-diagram/mermaid.min.js"></script>
75-
<script src="../site_libs/quarto-diagram/mermaid-init.js"></script>
76-
<link href="../site_libs/quarto-diagram/mermaid.css" rel="stylesheet">
7773

7874

7975
</head>
@@ -301,84 +297,11 @@ <h2 class="anchored" data-anchor-id="from-copilots-to-colleagues">From Copilots
301297
<p>This chapter explores a different organizational pattern: <strong>integrating AI agents as team members</strong>.</p>
302298
<p>Not as tools. Not as chatbots. But as entities that hold context, perform ongoing roles, and absorb responsibility within real teams.</p>
303299
<p>This is not a story about automation in the abstract. It is a practical method that emerges under specific constraints, introduces real pressures, and reshapes how work happens when speed outgrows structure.</p>
304-
<div class="cell" data-layout-align="default">
305-
<div class="cell-output-display">
306-
<div>
307-
<p></p><figure class="figure"><p></p>
308-
<div>
309-
<pre class="mermaid mermaid-js">flowchart TB
310-
311-
%% Phase 1
312-
subgraph P1["1. Constraint ID"]
313-
S0[Identify Human Bottleneck]
314-
end
315-
316-
%% Phase 2
317-
subgraph P2["2. Autonomy Enablement"]
318-
S1[Enable Autonomy]
319-
S1a[Provide Agentic Dev Access]
320-
S1b[Reduce Engineering Dependency]
321-
S1 --&gt; S1a
322-
S1 --&gt; S1b
323-
end
324-
325-
%% Phase 3
326-
subgraph P3["3. Agent-Supported Work"]
327-
S2[Independent Contribution]
328-
S2a[Locate Existing Components]
329-
S2b[Adapt and Assemble Functionality]
330-
S2 --&gt; S2a
331-
S2 --&gt; S2b
332-
end
333-
334-
%% Phase 4
335-
subgraph P4["4. Role Externalization"]
336-
S4[Product-Oriented Agent]
337-
S4a[Answer Routine Questions]
338-
S4b[Async Escalation]
339-
340-
S5[Architecture-Oriented Agent]
341-
S5a[Review Contributions]
342-
S5b[Enforce Constraints]
343-
344-
S4 --&gt; S4a
345-
S4 --&gt; S4b
346-
S5 --&gt; S5a
347-
S5 --&gt; S5b
348-
end
349-
350-
%% Phase 5
351-
subgraph P5["5. Emergent Process"]
352-
S6[Process Forms Implicitly]
353-
end
354-
355-
%% Phase 6
356-
subgraph P6["6. Stable Delivery"]
357-
S7[Delivery Cycle]
358-
S7a[Design]
359-
S7b[Build]
360-
S7c[Release]
361-
S7 --&gt; S7a
362-
S7 --&gt; S7b
363-
S7 --&gt; S7c
364-
end
365-
366-
%% Flow
367-
P1 --&gt; P2 --&gt; P3 --&gt; P4 --&gt; P5 --&gt; P6
368-
369-
%% Styling
370-
style P1 fill:#F5F7FA,stroke:#6B7280,stroke-width:1px
371-
style P2 fill:#E0F2FE,stroke:#0284C7,stroke-width:1px
372-
style P3 fill:#ECFDF5,stroke:#059669,stroke-width:1px
373-
style P4 fill:#FFF7ED,stroke:#EA580C,stroke-width:1px
374-
style P5 fill:#EEF2FF,stroke:#4F46E5,stroke-width:1px
375-
style P6 fill:#FDF2F8,stroke:#BE185D,stroke-width:1px
376-
377-
</pre>
378-
</div>
379-
<p></p></figure><p></p>
380-
</div>
381-
</div>
300+
<div class="quarto-figure quarto-figure-center">
301+
<figure class="figure">
302+
<p><img src="../images/ai-agents-workflow.png" class="img-fluid figure-img" alt="Flowchart showing the six-phase agent integration workflow from constraint identification through stable delivery"></p>
303+
<figcaption>Agent Integration Workflow</figcaption>
304+
</figure>
382305
</div>
383306
</section>
384307
<section id="context-when-speed-outgrows-structure" class="level2">
@@ -440,69 +363,11 @@ <h2 class="anchored" data-anchor-id="step-4-let-process-emerge-via-agents">Step
440363
<p>Together, these agents create something unusual: <strong>process without process</strong>.</p>
441364
<p>There are no new standing meetings. No heavy documentation mandates. No explicit bureaucracy.</p>
442365
<p>Structure emerges only where it is needed, mediated through agents rather than enforced through hierarchy.</p>
443-
<div class="cell" data-layout-align="default">
444-
<div class="cell-output-display">
445-
<div>
446-
<p></p><figure class="figure"><p></p>
447-
<div>
448-
<pre class="mermaid mermaid-js">flowchart LR
449-
%% Humans
450-
H[Humans Design · Product · Sales · Ops]
451-
452-
%% Product (External)
453-
Maya[Maya Product AI Design Leader – Customer-facing]
454-
455-
%% Internal Framework
456-
Framework[Agentic Framework Inspired by Maya]
457-
Mappy[Mappy PM &amp; Orchestration Agent]
458-
459-
%% Inputs
460-
Sales[Sales Calls &amp; Business Conversations]
461-
Slack[Slack Threads Async Input]
462-
463-
%% Process Stages
464-
Ideation[Ideation &amp; Prototyping]
465-
Design[Design Decisions &amp; Specs]
466-
Build[Build &amp; Implement]
467-
Ship[Ship &amp; Launch]
468-
Test[Test &amp; Observe]
469-
Learn[Learn &amp; Adapt]
470-
471-
%% Philosophy influence
472-
Maya -.-&gt;|Design philosophy guided creation, memory, structure| Framework
473-
474-
%% Human interaction
475-
H --&gt;|Ideas &amp; context| Framework
476-
Framework --&gt; Ideation
477-
Ideation --&gt; Design
478-
479-
%% Orchestration
480-
Design --&gt; Mappy
481-
Sales --&gt; Mappy
482-
Slack --&gt; Mappy
483-
484-
%% Mappy responsibilities
485-
Mappy --&gt;|Backlog &amp; Priorities| Build
486-
Mappy --&gt;|Design Docs| Build
487-
Mappy --&gt;|Decision Memory| Build
488-
489-
%% Delivery loop
490-
Build --&gt; Ship
491-
Ship --&gt; Test
492-
Test --&gt; Learn
493-
494-
%% Feedback loops
495-
Learn --&gt;|Insights| Framework
496-
Learn --&gt;|Updated priorities| Mappy
497-
498-
%% Async contribution
499-
H --&gt;|Async input| Slack
500-
501-
</pre>
502-
</div>
503-
<p></p></figure><p></p>
504-
</div>
505-
</div>
366+
<div class="quarto-figure quarto-figure-center">
367+
<figure class="figure">
368+
<p><img src="../images/ai-agents-framework.png" class="img-fluid figure-img" alt="Architecture diagram showing the flow from human input through Maya-inspired framework, Mappy orchestration, to the build-ship-test-learn delivery cycle"></p>
369+
<figcaption>Agentic Framework Architecture</figcaption>
370+
</figure>
506371
</div>
507372
</section>
508373
<section id="the-resulting-workflow" class="level2">

0 commit comments

Comments
 (0)