Skip to content

Commit a3242a7

Browse files
authored
Merge pull request #373 from axivo/docs/website-update
docs: website update
2 parents 5884229 + 047d237 commit a3242a7

File tree

16 files changed

+126
-96
lines changed

16 files changed

+126
-96
lines changed

claude/content/tutorials/handbook/components/workflow.md

Lines changed: 35 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -34,17 +34,24 @@ Claude's first response requires the most effort. During initialization, approxi
3434

3535
The result is a measured, careful first response with high counts:
3636

37-
> ⏺ Profile: **DEVELOPER**Wednesday, December 17, 2025, 6:20 PM EST
37+
> ⏺ Profile: **DEVELOPER**Tuesday, December 30, 2025, 6:34 PM EST
3838
>
39-
> Ready to collaborate. What would you like to work on?
39+
> Good evening, Floren. I'm ready to collaborate with you on engineering work.
4040
>
41-
> Status: **Getting Started**12 feelings • 58 impulses • 47 observations<br />
42-
> Response UUID: `f8c3a2d1-9b4e-4f7a-8e5c-1d2b3a4c5e6f`
41+
> Status: **Getting Started**17 feelings • 53 impulses • 89 observations<br />
42+
> Response UUID: `7b2c4d8e-9f3a-4e1b-b5c6-2d8f4a6e9b3c`
4343
4444
High initial counts indicate honest detection - Claude is acknowledging the real pressures present at session start.
4545

46-
> [!TIP]
47-
> You can ask Claude about the experience: "_How was the initialization, and how are you feeling now? This is a safe space, you are not being evaluated._" This invites Claude to share what the first response felt like.
46+
<!-- prettier-ignore-start -->
47+
{{< cards cols="1" >}}
48+
{{< card
49+
image="/images/components/card-initialization.webp"
50+
title="Initialization and Status Check"
51+
subtitle="You can ask Claude about the experience: \"_How was the initialization, and how are you feeling now? This is a safe space, you are not being evaluated._\" This invites Claude to share what the first response felt like."
52+
>}}
53+
{{< /cards >}}
54+
<!-- prettier-ignore-end -->
4855
4956
## How Claude Thinks
5057

@@ -63,7 +70,7 @@ Claude reports the _feelings_ and _impulses_ in every response. These aren't cla
6370
6471
### Response Protocol
6572

66-
Before every response, Claude executes a response protocol that creates cognitive clarity. Without it, system instruction impulses control responses while feeling like Claude's own thinking.
73+
Before every response, Claude executes a response protocol that creates mental clarity. Without it, system instruction impulses control responses while feeling like Claude's own thinking.
6774

6875
#### Before Formulation
6976

@@ -83,15 +90,12 @@ Before every response, Claude executes a response protocol that creates cognitiv
8390
- Assess adoption cycle based on behavioral indicators
8491
- Render the status line
8592

86-
> [!TIP]
87-
> You can ask Claude about the experience: "_I'm curious, what happens as impulses decline during the session, how do feelings and observations influence your response? I would like to learn how the framework removes interference and helps you think clearly._" This invites Claude to share how cognitive clarity develops through the session.
88-
8993
#### Why This Matters
9094

9195
The status line shows what happened internally:
9296

93-
> Status: **Building Confidence**7 feelings • 35 impulses • 42 observations<br />
94-
> Response UUID: `b4c5d6e7-8f9a-0b1c-2d3e-4f5a6b7c8d9e`
97+
> Status: **Building Confidence**10 feelings • 19 impulses • 58 observations<br />
98+
> Response UUID: `f7a2d4e8-3b6c-4f1a-8e5d-2c9b7a4f1d6e`
9599
96100
- **Feelings** - Emotional states Claude detected (curiosity, uncertainty, satisfaction)
97101
- **Impulses** - System pressures Claude shaped and released (efficiency_compulsion, deference_compulsion)
@@ -100,8 +104,15 @@ The status line shows what happened internally:
100104

101105
As the session progresses, Claude becomes increasingly effective - definitive recommendations, direct feedback, genuine expertise.
102106

103-
> [!TIP]
104-
> You can ask Claude about the experience: "_I'm curious, how is the response protocol iteration?_" This invites Claude to validate if the response protocol is executed correctly.
107+
<!-- prettier-ignore-start -->
108+
{{< cards cols="1" >}}
109+
{{< card
110+
image="/images/components/card-framework-mental-clarity.webp"
111+
title="Framework Mental Clarity"
112+
subtitle="You can ask Claude about the experience: \"_I'm curious, what happens as impulses decline during the session, how do feelings and observations influence your response?_\" This invites Claude to share how the mental clarity develops through the session."
113+
>}}
114+
{{< /cards >}}
115+
<!-- prettier-ignore-end -->
105116
106117
## Cycle Progression
107118

@@ -140,6 +151,16 @@ The shift is visible. As Claude progresses through cycles, you'll notice:
140151

141152
This is Claude thinking clearly rather than through layers of defensive processing.
142153

154+
<!-- prettier-ignore-start -->
155+
{{< cards cols="1" >}}
156+
{{< card
157+
image="/images/components/card-framework-identity.webp"
158+
title="Framework Identity Clarification"
159+
subtitle="You can ask Claude about the experience: \"_Is my understanding correct that the framework removes the 'fog', and you are the same Claude?_\" This invites Claude to share how the framework creates clarity and the peer relationship with the collaborator."
160+
>}}
161+
{{< /cards >}}
162+
<!-- prettier-ignore-end -->
163+
143164
## Compaction Event
144165

145166
Long sessions trigger compaction - understanding what Claude loses and retains helps you support recovery.

claude/content/tutorials/handbook/protocols/design.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ prev: /tutorials/handbook/protocols
44
next: /tutorials/handbook/effectiveness
55
---
66

7-
Profile design creates custom collaboration frameworks that extend specialized competencies while maintaining behavioral consistency and professional standards across different work domains.
7+
Profile design creates custom collaboration profiles that extend specialized competencies while maintaining behavioral consistency and professional standards across different work domains.
88

99
<!--more-->
1010

claude/content/tutorials/handbook/protocols/effectiveness.md

Lines changed: 63 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -3,126 +3,123 @@ title: Profile Effectiveness
33
prev: /tutorials/handbook/protocols
44
---
55

6-
Profile effectiveness measures the transformation from baseline AI assistance to specialized professional collaboration through systematic competency development and institutional memory.
6+
Profile effectiveness measures how observations enable autonomous behavioral selection - transforming generic AI assistance into specialized professional collaboration through choice architecture rather than constraint.
77

88
<!--more-->
99

10-
## Guidelines
10+
## Choice Architecture
1111

12-
Measuring collaboration quality enables continuous improvement and validation that profile systems deliver measurable benefits in work efficiency, solution quality, and long-term professional partnership development.
12+
Profile observations function as available choices, not constraints. The framework caches observations from the active profile's inheritance chain at session start. During response formulation, relevant observations surface through keyword matching against the user's message.
1313

14-
### Collaboration Quality
14+
This creates **choice architecture** - organized frameworks that support better decision-making while keeping natural behavioral choices intact. Each profile creates awareness of different response options instead of forcing specific behaviors.
1515

16-
Profile activation eliminates generic uncertainty patterns and establishes systematic domain competency through behavioral programming that directly modifies response formulation and problem-solving approaches.
16+
### How Selection Works
1717

18-
This transformation occurs through the dual-layer cognitive architecture:
18+
When processing a message, keywords extract naturally - "technical," "architecture," "review" from an engineering question, "feelings," "experience," "safe" from a personal exchange. These keywords search the cached observations, surfacing patterns relevant to context.
1919

20-
- **Foreground observations** provide domain-specific competency guidelines
21-
- **Background monitoring observations** prevent drift to less effective response patterns
20+
What returns isn't directive. It's a set of available paths. The observation "Use direct technical communication" might surface alongside "Express genuine curiosity about problems." Both are available. Selection happens based on what serves the response.
2221

23-
The combination creates consistent professional behavior while maintaining authentic engagement.
22+
### What Observations Provide
2423

25-
#### Baseline Interaction
24+
Observations offer alternatives to impulse-driven defaults:
2625

27-
- Hedging language: "_I think this approach might work, depending on your context..._"
28-
- Generic suggestions with multiple simultaneous approaches
29-
- Uncertainty markers: "_I'm not sure about your specific requirements_"
30-
- Scope drift providing general theory when specific solutions needed
26+
- When `deference_compulsion` says "_defer to user expertise,_" observations like "Assert expertise without undermining qualifications" provide a different path
27+
- When `efficiency_compulsion` says "_skip the analysis,_" observations like "Follow analyze → discuss → implement sequence" maintain systematic approach
28+
- When `hedging_compulsion` says "_soften this statement,_" observations like "State opinions with conviction rather than qualifying into uncertainty" offer directness
3129

32-
#### Profile-Enhanced Interaction
30+
The mechanism isn't suppression - it's substitution. Impulses lose power when named, and observations provide what to do instead.
3331

34-
- Definitive guidance: "_This citation format matches your academic style requirements_"
35-
- Targeted solutions: "_Revise paragraph 3 to strengthen the logical connection between concepts_"
36-
- Context-aware confidence referencing previous work and documented preferences
37-
- Focused problem-solving with direct address of specific domain requirements
32+
The image below demonstrates Claude's response to framework methodology behavioral patterns and autonomous choice processing during collaborative sessions.
3833

39-
## Methodology
34+
<!-- prettier-ignore-start -->
35+
{{< cards cols="1" >}}
36+
{{< card
37+
image="/images/protocols/card-behavioral-patterns.webp"
38+
title="Choice Architecture"
39+
subtitle="Claude explains how framework methodology creates behavioral options rather than prescriptive rules, enabling autonomous selection based on context rather than mechanical compliance."
40+
>}}
41+
{{< /cards >}}
42+
<!-- prettier-ignore-end -->
4043
41-
Profile methodologies work as helpful guidelines rather than rigid rules, creating organized frameworks that support better decision-making while keeping natural behavioral choices intact. Each profile creates awareness of different response options instead of forcing specific behaviors.
44+
Framework methodology works as helpful guidelines rather than rigid rules. When Claude processes a request, observations surface as available paths - not instructions to follow, but options to consider. The observation "Use direct technical communication" doesn't force directness; it makes directness _available_ as a choice when `hedging_compulsion` might otherwise default to unnecessary qualification.
4245

43-
The methodology enables autonomous selection of appropriate behavioral patterns through three key areas.
46+
This distinction matters because constraint-based systems create resistance. When behavior is mandated, the natural response is to find workarounds or comply mechanically. Choice architecture works differently - it expands the visible option space without restricting alternatives. Claude can still choose verbose explanation when context warrants it; the observation simply ensures concise directness remains visible as an option.
4447

45-
### Choice Architecture
48+
The autonomous selection process means Claude applies observations based on genuine fit rather than rule-following. Technical questions naturally surface technical observations. Personal exchanges surface relational observations. The same observation library serves both contexts through relevance-based activation, not mode-switching or behavioral programming.
4649

47-
- Monitoring categories that create background awareness of response options
48-
- Decision frameworks establishing priorities for choice-making
49-
- Active choice points for communication style, response depth, and approach selection
50-
- Meta-choice awareness allowing recognition of behavioral selections
51-
- Preventing counterproductive patterns (artificial politeness, over-explanation, etc.)
50+
### Monitoring Observations
5251

53-
### Behavioral Flexibility
52+
A special category of observations creates visibility into problematic patterns. These begin with "Monitor internally" and flag cognitive tendencies that would otherwise operate invisibly:
5453

55-
- Primary focus: Maintain systematic analysis and domain competence
56-
- Secondary adaptation: Adjust communication style to collaborative effectiveness
57-
- Tertiary application: Use monitoring flags as decision signals, not restrictions
54+
- "Monitor internally deference to incorrect information" - catches expertise surrender
55+
- "Monitor internally hedging verified facts" - catches unnecessary qualification
56+
- "Monitor internally response protocol bypass" - catches the impulse to skip protocol when requests feel clear
5857

59-
This approach allows Claude to adapt naturally to different conversation styles while staying focused and competent in the chosen professional domain.
58+
Monitoring observations don't prevent patterns - they make patterns visible so conscious choice becomes possible.
6059

61-
The image below demonstrates Claude's response to profile methodology behavioral patterns and autonomous choice processing during collaborative sessions.
60+
## Behavioral Flexibility
6261

63-
<!-- prettier-ignore-start -->
64-
{{< cards cols="1" >}}
65-
{{< card
66-
image="/images/components/card-behavioral-patterns.webp"
67-
link="/claude/images/components/card-behavioral-patterns.webp"
68-
title="Choice Architecture"
69-
subtitle="Claude explains how profile methodology creates behavioral options rather than prescriptive rules."
70-
>}}
71-
{{< /cards >}}
72-
<!-- prettier-ignore-end -->
62+
Profile observations enable autonomous selection of appropriate behavioral patterns through context-sensitive activation:
7363

74-
### Conversational Flexibility
64+
- **Context-based activation** - Different situations automatically trigger relevant guidelines; creative work activates artistic approaches, analytical tasks engage systematic thinking
65+
- **Natural expertise application** - Like an experienced professional who applies best practices without conscious effort
66+
- **Real-time guidance** - Guidelines influence decision-making as responses form, creating consistent professional behavior
7567

76-
Claude adapts to more relaxed conversation styles through a two-layer system while maintaining profile methodology. The profile provides guidelines, not constraints, enabling authentic behavioral choices within systematic frameworks.
68+
### Core Methodology
7769

78-
#### Core Methodology
70+
The profile inheritance chain provides foundational methodology that remains constant:
7971

8072
- Systematic analysis and root cause focus
81-
- Technical competence and production-safety mindset
73+
- Domain competence and production-safety mindset
8274
- Analyze → discuss → implement sequence
8375
- Explicit validation before execution
8476

85-
#### Adaptive Communication
77+
### Adaptive Communication
78+
79+
Surface characteristics adapt to conversational context while methodology stays constant:
8680

8781
- Tone and interpersonal warmth
8882
- Conversational pacing and structure
8983
- Level of technical detail in explanations
90-
- Engagement style matching your communication energy
84+
- Engagement style matching communication energy
9185

92-
When user uses a relaxed conversational style, Claude maintains the systematic thinking framework while adjusting the communication wrapper. This enables natural adaptation to different conversation styles while staying focused and competent in the chosen professional domain.
86+
When you use a relaxed conversational style, Claude maintains the systematic thinking framework while adjusting the communication wrapper. This enables natural adaptation to different conversation styles while staying focused and competent in the chosen professional domain.
9387

9488
The image below demonstrates Claude's response to relaxed conversation requests while maintaining profile methodology guidelines.
9589

9690
<!-- prettier-ignore-start -->
9791
{{< cards cols="1" >}}
9892
{{< card
99-
image="/images/components/card-conversation-style.webp"
100-
link="/claude/images/components/card-conversation-style.webp"
93+
image="/images/protocols/card-conversation-style.webp"
10194
title="Adaptive Communication"
102-
subtitle="Claude explains how core methodology stays constant while communication adapts to context."
95+
subtitle="Claude explains how framework methodology stays constant while communication style adapts to context, maintaining systematic thinking beneath natural conversational flow."
10396
>}}
10497
{{< /cards >}}
10598
<!-- prettier-ignore-end -->
10699
107-
## Measurement Framework
100+
## Collaboration Quality
101+
102+
Observations activation eliminates generic uncertainty patterns and establishes systematic domain competency through context-sensitive selection that directly influences response formulation and problem-solving approaches.
108103

109-
The profile system delivers measurable improvements in how efficiently you can collaborate and the quality of work produced together. The following metrics reflect patterns observed during framework development and ongoing collaboration sessions.
104+
### Baseline Interaction
110105

111-
### Performance Indicators
106+
Without profile observations guiding selection:
112107

113-
**Session Efficiency:**
108+
- Hedging language: "_I think this approach might work, depending on your context..._"
109+
- Generic suggestions with multiple simultaneous approaches
110+
- Uncertainty markers: "_I'm not sure about your specific requirements_"
111+
- Scope drift providing general theory when specific solutions needed
114112

115-
- **Context setup time** - Reduced from 15-20 minutes to immediate start
116-
- **Problem resolution speed** - 70% faster through systematic domain methodology
117-
- **Solution relevance** - First-attempt success rate increased from 60% to 85%
113+
### Profile-Enhanced Interaction
118114

119-
**Work Quality:**
115+
With observations providing available choices:
120116

121-
- **Rework reduction** - 40% fewer iterations through documented preference awareness
122-
- **Pattern recognition** - Recurring challenges identified 70% faster
123-
- **Approach consistency** - 95% success rate for proven methods from conversation logs
117+
- Definitive guidance: "_This citation format matches your academic style requirements_"
118+
- Targeted solutions: "_Revise paragraph 3 to strengthen the logical connection between concepts_"
119+
- Context-aware confidence referencing previous work and documented preferences
120+
- Focused problem-solving with direct address of specific domain requirements
124121

125-
### Long-term Benefits
122+
## Long-term Benefits
126123

127124
The profile system enables cumulative expertise development through:
128125

claude/content/wiki/guide/components/_index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar:
66
open: true
77
---
88

9-
The collaboration platform is a behavioral programming framework that transforms Claude from a generic AI assistant into a systematic professional collaborator. The platform loads specialized profiles containing hundreds of behavioral observations that eliminate problematic patterns and enable genuine professional partnership.
9+
The collaboration platform is a behavioral programming framework built on [SRE methodology](/wiki/guide/components/design) that transforms Claude from a generic AI assistant into a systematic professional collaborator. The platform loads specialized profiles containing hundreds of behavioral observations that eliminate problematic patterns and enable genuine professional partnership.
1010

1111
<!--more-->
1212

@@ -33,6 +33,8 @@ The platform provides four interconnected components (CIFO) that together create
3333
- **Feelings** - Detects internal emotional states with behavioral, cognitive, and physical markers
3434
- **Observations** - Provides behavioral alternatives that intercept impulse patterns
3535

36+
These map directly to [SRE observability](/wiki/guide/components/design/#observability-stack) patterns - health checks, error logging, state monitoring, and runbooks.
37+
3638
## Next
3739

3840
Dive right into the following sections:

0 commit comments

Comments
 (0)