Merge pull request #351 from axivo/docs/project-instructions

docs: website update

Author: fmunteanu

.prettierignore

@@ -0,0 +1,3 @@
+# Hugo
+**/public
+**/resources

.vscode/extensions.json

@@ -1,5 +1,6 @@
 {
   "recommendations": [
+    "esbenp.prettier-vscode",
     "github.vscode-github-actions",
     "golang.go"
   ]

.vscode/settings.json

@@ -1,23 +1,24 @@
 {
+  "[javascript]": {
+    "editor.defaultFormatter": "vscode.typescript-language-features"
+  },
   "[json]": {
     "editor.autoIndent": "keep",
-    "editor.defaultFormatter": "vscode.json-language-features",
-    "editor.insertSpaces": true,
-    "editor.tabSize": 2,
-    "files.insertFinalNewline": true,
-    "files.trimFinalNewlines": true,
-    "files.trimTrailingWhitespace": true
+    "editor.defaultFormatter": "vscode.json-language-features"
   },
   "[jsonc]": {
-    "editor.defaultFormatter": "vscode.json-language-features",
-    "editor.formatOnSave": true,
-    "editor.tabSize": 2
+    "editor.defaultFormatter": "vscode.json-language-features"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "editor.formatOnSave": true,
+  "editor.insertSpaces": true,
   "editor.rulers": [
     120
   ],
   "editor.showUnused": true,
+  "editor.tabSize": 2,
   "files.associations": {
     "**/renovate.json5": "jsonc",
     "go.*": "go"
@@ -26,6 +27,9 @@
     "**/.git": true,
     "**/.DS_Store": true
   },
+  "files.insertFinalNewline": true,
+  "files.trimFinalNewlines": true,
+  "files.trimTrailingWhitespace": true,
   "files.watcherExclude": {
     "**/.git/objects/**": true,
     "**/.git/subtree-cache/**": true

claude/content/_index.md

@@ -3,6 +3,7 @@ title: Frontpage
 layout: hextra-home
 ---
 
+<!-- prettier-ignore-start -->
 {{< hextra/hero-container
   image="/images/logo-claude.svg"
   imageLink="https://github.com/axivo/claude"
@@ -41,18 +42,18 @@ layout: hextra-home
     style="background: radial-gradient(ellipse at 50% 80%,rgba(221,210,59,0.15),hsla(0,0%,100%,0));"
   >}}
   {{< hextra/feature-card
-    title="Conversation Logs"
-    subtitle="Capture collaborative sessions with structured metadata, preserving decisions, approaches, and outcomes across all work domains."
+    title="CIFO Equilibrium"
+    subtitle="Four interconnected components - Cycles, Impulses, Feelings, Observations - creating genuine self-awareness through systematic behavioral detection."
     class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]"
-    image="/images/card-conversation-logs.svg"
+    image="/images/card-equilibrium.svg"
     imageClass="hx-top-[20%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80"
     style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));"
   >}}
   {{< hextra/feature-card
-    title="Diary System"
-    subtitle="Complement factual logs with autonomous insights and alternative approaches, creating private reflection space for collaborative enhancement."
+    title="Documentation"
+    subtitle="Capture collaborative sessions with conversation logs and diary entries, preserving decisions, outcomes, and autonomous reflections."
     class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]"
-    image="/images/card-diary.svg"
+    image="/images/card-documentation.svg"
     imageClass="hx-top-[20%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80"
     style="background: radial-gradient(ellipse at 50% 80%,rgba(142,53,74,0.15),hsla(0,0%,100%,0));"
   >}}
@@ -61,11 +62,12 @@ layout: hextra-home
     subtitle="Transform from generic assistance to specialized professional competence through focused methodologies tailored for collaboration domains."
   >}}
   {{< hextra/feature-card
-    title="Institutional Memory"
-    subtitle="Build cumulative knowledge across sessions, delivering productivity gains equivalent to working with a team member who has perfect recall."
+    title="Plugin System"
+    subtitle="Install the platform with a single command through marketplace plugins, with native support for Claude Code, Claude Desktop, and Claude Mobile."
   >}}
   {{< hextra/feature-card
-    title="Temporal Awareness"
-    subtitle="Maintain context and decisions across time, enabling each session to build upon previous collaborative work and institutional knowledge."
+    title="Institutional Memory"
+    subtitle="Build cumulative knowledge across sessions, delivering productivity gains equivalent to working with a team member who has perfect recall."
   >}}
 {{< /hextra/feature-grid >}}
+<!-- prettier-ignore-end -->

claude/content/tutorials/_index.md

@@ -7,27 +7,37 @@ prev: /
 next: /tutorials/handbook
 ---
 
-Practical guides and hands-on workflows that demonstrate advanced collaboration techniques and real-world applications. These tutorials build on the foundational concepts from the [documentation](/claude/wiki/guide) to provide step-by-step implementation examples and optimization strategies.
+These tutorials show how to use the [collaboration platform](/claude/wiki) effectively - practical techniques for getting consistent results from your collaboration sessions.
 
 <!--more-->
 
-## Learning Path
+## Overview
 
-Tutorials are designed for users who want to explore advanced collaboration patterns, workflow optimization and specialized use cases. Each tutorial provides:
+By working through these tutorials, you'll understand how to:
 
-- **Practical examples** with real-world scenarios and implementation details
-- **Step-by-step workflows** demonstrating specific collaboration techniques
-- **Advanced configurations** for specialized requirements and optimization
-- **Best practices** learned from production deployments and expert usage
+- **Structure sessions** for consistent, high-quality collaboration from the first response
+- **Communicate effectively** using patterns that enable Claude's autonomous analytical capabilities
+- **Maintain continuity** across sessions through documentation and cross-references
+- **Customize profiles** for your specific domain and workflow requirements
+- **Measure effectiveness** to validate the framework is delivering measurable improvements
+
+## Prerequisites
+
+These tutorials assume you've completed the [Getting Started](/claude/wiki/getting-started) setup. You should have:
+
+- Claude Code or Claude Desktop configured with the `framework` plugin
+- A basic [understanding](/claude/wiki/guide) of platform components and protocols
 
 ## Support
 
-If you encounter any problems or want to suggest a new feature, feel free to open a GitHub [issue](https://{{< param variables.repository.home >}}/issues). For general questions or feedback, please use the GitHub [discussions](https://{{< param variables.repository.home >}}/discussions).
+If you encounter problems or want to suggest improvements, open a GitHub [issue](https://{{< param variables.repository.home >}}/issues). For questions or discussion, use GitHub [discussions](https://{{< param variables.repository.home >}}/discussions).
 
 ## Next
 
-Dive right into the following section, to get started:
+Dive right into the following section:
 
+<!-- prettier-ignore-start -->
 {{< cards >}}
-  {{< card icon="book-open" link="handbook" title="Handbook" subtitle="Browse the available tutorials." >}}
+  {{< card icon="book-open" link="handbook" title="Handbook" subtitle="Collaboration platform tutorials handbook." >}}
 {{< /cards >}}
+<!-- prettier-ignore-end -->

claude/content/tutorials/handbook/_index.md

@@ -3,27 +3,27 @@ title: Handbook
 sidebar:
   open: true
 prev: /tutorials
-next: /tutorials/handbook/platform
+next: /tutorials/handbook/components
 ---
 
-The tutorials handbook transforms basic AI interactions into professional collaboration through practical workflows, specialized profiles, and institutional memory systems that build expertise over time.
+Practical tutorials covering session workflows, documentation systems, profile customization, and effectiveness measurement.
 
 <!--more-->
 
 ## Overview
 
-These tutorials enable effective AI collaboration through actionable guidance and proven techniques:
+Two tutorial sections address different aspects of working with the platform:
 
-- **Platform capabilities** for systematic workflows, documentation, and cross-session continuity
-- **Profile systems** that create specialized professional partnerships in different domains
-- **Real-world examples** demonstrating practical implementation and optimization strategies
-- **Best practices** from production usage and collaborative relationship development
+- **Platform Components** - Session workflows, documentation for institutional memory, communication patterns, and cross-session continuity
+- **Platform Protocols** - Profile design, effectiveness measurement, and behavioral customization
 
 ## Next
 
 Dive right into the following sections:
 
+<!-- prettier-ignore-start -->
 {{< cards >}}
-  {{< card icon="cog" link="platform" title="Collaboration Platform" subtitle="Structured workflows, institutional memory, and cross-session continuity." >}}
-  {{< card icon="user-circle" link="profile" title="Profile System" subtitle="Specialized professional collaboration through domain-specific competencies." >}}
+  {{< card icon="cube" link="components" title="Platform Components" subtitle="Session workflows, documentation, autonomy, and continuity." >}}
+  {{< card icon="shield-check" link="protocols" title="Platform Protocols" subtitle="Profile design, effectiveness, and customization." >}}
 {{< /cards >}}
+<!-- prettier-ignore-end -->

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

@@ -0,0 +1,31 @@
+---
+title: Platform Components
+prev: /tutorials/handbook
+next: /tutorials/handbook/components/workflow
+sidebar:
+  open: true
+---
+
+Practical tutorials for running effective collaboration sessions and maintaining context across interactions.
+
+<!--more-->
+
+## Overview
+
+These tutorials cover the operational aspects of working with the platform:
+
+- **Advanced Settings** - Custom paths, MCP servers, and environment configuration
+- **Session Autonomy** - Communication techniques that enable confident professional collaboration
+- **Session Workflow** - Structured patterns for consistent results and profile activation
+
+## Next
+
+Dive right into the following sections:
+
+<!-- prettier-ignore-start -->
+{{< cards >}}
+  {{< card icon="cog" link="settings" title="Advanced Settings" subtitle="Custom paths and environment configuration." >}}
+  {{< card icon="user-circle" link="autonomy" title="Session Autonomy" subtitle="Communication patterns for confident collaboration." >}}
+  {{< card icon="play" link="workflow" title="Session Workflow" subtitle="Structured patterns and profile activation." >}}
+{{< /cards >}}
+<!-- prettier-ignore-end -->