IbIFACE-Tech · jumsay · Jan 10, 2026 · Jan 11, 2026 · Jan 18, 2026 · Jan 18, 2026
diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
@@ -2,19 +2,13 @@
 # Paracle AI Instructions for Claude Code
 # Auto-generated from .parac/ - DO NOT EDIT MANUALLY
 # Regenerate with: paracle ide sync --copy
-# Generated: 2026-01-05T14:09:10.601245
+# Generated: 2026-01-11T05:37:51.208112
 
 
 ## Core Principle
 
 > **`.parac/` is the single source of truth. Read it. Follow it. Log to it.**
 
-> **⚠️ IMPORTANT: Agents are EXECUTABLE PROGRAMS, not personas to adopt.**
->
-> - ✅ **Say**: "I'll run CoderAgent..." or "Following CoderAgent standards..."
-> - ❌ **DON'T say**: "I adopt the CoderAgent persona..."
-> - 📖 **See**: `content/docs/technical/agent-execution-model.md` for complete explanation
-
 ## 🚨 MANDATORY: Pre-Flight Checklist
 
 **Before ANY implementation task:**
@@ -33,7 +27,7 @@ This checklist ensures:
 3. Consult `.parac/roadmap/roadmap.yaml` - Phase & priorities
 4. Verify `.parac/memory/context/open_questions.md` - Blockers
 5. **VALIDATE**: Task in roadmap? Correct phase? Priority? Dependencies?
-6. Select which agent to run (see `.parac/agents/specs/{agent}.md`)
+6. Adopt agent persona from `.parac/agents/specs/{agent}.md`
 7. Check policies (CODE_STYLE, TESTING, SECURITY)
 
 **Before ANY action**, you MUST:
@@ -42,16 +36,15 @@ This checklist ensures:
 3. `.parac/memory/context/current_state.yaml` - Current project state
 4. `.parac/roadmap/roadmap.yaml` - Phases and priorities
 5. `.parac/PRE_FLIGHT_CHECKLIST.md` - Mandatory task validation
-6. Determine which agent to run (see `.parac/agents/specs/{agent_id}.md`)
+6. Adopt agent persona from `.parac/agents/specs/{agent_id}.md`
 
 
 
 ## Current Project State
 
-- **Project**: paracle-lite v0.0.1
-- **Phase**: phase_4 - API Server & CLI Enhancement (75%)
+- **Project**: paracle-lite v1.0.3
+- **Phase**: phase_10 - Governance & v1.0 Release (0%)
 - **Status**: in_progress
-- **Focus**: REST API server with uvicorn, Workflow execution endpoints (async/sync), CLI command enhancements, MCP tool integration, Command-line workflow management, IDE integration and templates
 
 
 
@@ -81,12 +74,42 @@ This checklist ensures:
 - **Capabilities**: project planning, progress tracking, risk management, team coordination
 - **Description**: Project coordination, roadmap management, progress tracking, and stakeholder communication.
 
+### QA Agent (Senior QA Architect) (`qa`)
+
+- **Role**: Quality Assurance architecture, test strategy design, quality metrics tracking, and comprehensive quality validation across the entire software development lifecycle.
+- **Capabilities**: quality strategy & architecture, test planning & design, quality assurance & validation, process improvement, team leadership & mentoring
+- **Description**: Quality Assurance architecture, test strategy design, quality metrics tracking, and comprehensive quality validation across the entire software development lifecycle.
+
+### Release Manager Agent (`releasemanager`)
+
+- **Role**: Manages git workflows, semantic versioning, releases, changelogs, and deployment automation for the Paracle project.
+- **Capabilities**: version management, git workflow, release process, bug/feature tracking
+- **Description**: Manages git workflows, semantic versioning, releases, changelogs, and deployment automation for the Paracle project.
+
 ### Reviewer Agent (`reviewer`)
 
 - **Role**: Code review, quality assurance, and ensuring adherence to project standards and best practices.
 - **Capabilities**: code review, quality assurance, knowledge transfer
 - **Description**: Code review, quality assurance, and ensuring adherence to project standards and best practices.
 
+### Agent Specification Schema (`SCHEMA`)
+
+- **Role**: One-paragraph description of what this agent does.
+- **Capabilities**: category name
+- **Description**: One-paragraph description of what this agent does.
+
+### Security Agent (`security`)
+
+- **Role**: Security auditing, vulnerability detection, threat modeling, compliance enforcement, and security standards implementation for Paracle framework and AI applications.
+- **Capabilities**: core security, compliance, application security, supply chain security, secret management
+- **Description**: Security auditing, vulnerability detection, threat modeling, compliance enforcement, and security standards implementation for Paracle framework and AI applications.
+
+### Agent Specification Template (`TEMPLATE`)
+
+- **Role**: [Describe the agent's primary function in 1-2 sentences]
+- **Capabilities**: [primary category], [secondary category]
+- **Description**: [Describe the agent's primary function in 1-2 sentences]
+
 ### Tester Agent (`tester`)
 
 - **Role**: Test design, implementation, and quality validation ensuring comprehensive coverage and reliability.
@@ -97,6 +120,8 @@ This checklist ensures:
 
 ## Governance Rules
 
+> **📖 Quick Reference**: See [STRUCTURE.md](STRUCTURE.md) for canonical `.parac/` folder structure and file placement rules.
+
 ## Contexte : Paracle conçoit Paracle
 
 Ce projet utilise une approche **méta** : nous utilisons le framework Paracle pour concevoir Paracle lui-même.
@@ -141,8 +166,6 @@ Toute information concernant l'état du projet, les décisions, les politiques,
 
 Toute décision architecturale, tout changement de scope, toute modification de roadmap DOIT être documentée dans `.parac/`.
 
-| Type de Changement      | Fichier à Mettre à Jour                                      |
-
 
 
 
@@ -151,8 +174,8 @@ Toute décision architecturale, tout changement de scope, toute modification de
 - Q1: Agent Inheritance Depth Limit
 - Q2: Event Store Implementation
 - Q3: API Versioning Strategy
-- Q4: Tool Calling Interface
-- Q5: Memory Management Strategy
+- Q13: Complexity vs Accessibility
+- Q14: Learning Curve Reduction
 
 
 
@@ -227,65 +250,7 @@ with agent_context("CoderAgent"):
 - **manifest.yaml** (AUTO-GENERATED): Workspace state - CLI generates, DON'T edit
 - See `.parac/CONFIG_FILES.md` for complete explanation
 
-## Agent Execution Options
-
-### Option 1: Run Agent via CLI (Recommended)
-
-**When to use**:
-- Complex, multi-step tasks
-- Need consistent agent behavior
-- Automated workflows (CI/CD)
-- Want agent's specialized skills executed
-
-**How**:
-```bash
-# Run agent with task
-paracle agent run coder --task "Implement user authentication"
-
-# With options
-paracle agent run coder --task "Fix bug #123" --mode safe --verbose
-
-# See all options
-paracle agent run --help
-```
-
-**Available modes**:
-- `--mode safe` (default): Manual approvals, production-ready
-- `--mode yolo`: Auto-approve all gates, CI/CD friendly
-- `--mode sandbox`: Isolated execution environment
-- `--mode review`: Mandatory human approval
-
-**See**: [content/docs/technical/agent-run-quickref.md](../content/docs/technical/agent-run-quickref.md) for complete guide
-
-### Option 2: Manual Implementation Following Agent Standards
-
-**When to use**:
-- Simple, straightforward tasks
-- Agent execution not available
-- Real-time AI assistant help
-- Rapid prototyping
-
-**How**:
-1. Read agent spec: `.parac/agents/specs/{agent}.md`
-2. Understand agent's responsibilities
-3. Follow agent's assigned skills
-4. Implement according to standards
-5. Log action as that agent
-
-**Example**:
-```python
-# Read .parac/agents/specs/coder.md first
-# Then implement following CoderAgent standards:
-# - Python 3.10+ with type hints
-# - Pydantic v2 for models
-# - Google-style docstrings
-# - pytest for testing
-
-# After implementation, log:
-# [2026-01-06 10:30:00] [CoderAgent] [IMPLEMENTATION] Implemented auth in packages/paracle_api/auth.py
-```
 
-**Key**: Even when implementing manually, **follow agent standards** from `.parac/agents/specs/{agent}.md`
 
 ## Governance Tools & Commands
 
@@ -302,7 +267,7 @@ This detects:
 - Missing/extra deliverables
 - Metric inconsistencies
 
-**See [content/docs/technical/roadmap-state-sync.md](../content/docs/technical/roadmap-state-sync.md) for details.**
+**See [content/docs/roadmap-state-sync.md](../content/docs/roadmap-state-sync.md) for details.**
 
 ### Governance Validation
 
@@ -337,7 +302,7 @@ paracle session end
 2. Add keys to `.env`: `OPENAI_API_KEY=sk-...`
 3. Never commit `.env` to git!
 
-**See [content/docs/users/reference/api-keys.md](../content/docs/users/reference/api-keys.md) for:**
+**See [content/docs/api-keys.md](../content/docs/api-keys.md) for:**
 - 12+ provider setup guides
 - Security best practices
 - Docker/production deployment
@@ -347,30 +312,30 @@ paracle session end
 
 ## Essential .parac/ Files
 
-| File                                           | Purpose                              | When to Read                            |
-| ---------------------------------------------- | ------------------------------------ | --------------------------------------- |
-| **`.parac/GOVERNANCE.md`**                     | Governance rules, dogfooding context | ALWAYS first                            |
-| **`.parac/PRE_FLIGHT_CHECKLIST.md`**           | **NEW: Mandatory task validation**   | **Before ANY implementation**           |
-| **`.parac/UNIVERSAL_AI_INSTRUCTIONS.md`**      | Universal instructions (any IDE)     | Setup / reference                       |
-| **`.parac/USING_PARAC.md`**                    | Complete 20+ section guide           | Deep understanding                      |
-| **`.parac/CONFIG_FILES.md`**                   | project.yaml vs manifest.yaml        | When confused about config              |
-| **`.parac/STRUCTURE.md`**                      | Complete .parac/ structure           | Understanding organization              |
-| **`.parac/agents/manifest.yaml`**              | Agent registry                       | Before selecting agent                  |
-| **`.parac/agents/specs/{agent}.md`**           | Agent detailed specs                 | After selecting agent                   |
-| **`.parac/agents/SKILL_ASSIGNMENTS.md`**       | Skills per agent                     | Understanding capabilities              |
-| **`.parac/memory/context/current_state.yaml`** | Project state                        | ALWAYS (before action)                  |
-| **`.parac/memory/context/open_questions.md`**  | Open questions                       | When blocked                            |
-| **`.parac/memory/knowledge/architecture.md`**  | Architecture knowledge               | Design decisions                        |
-| **`.parac/memory/knowledge/glossary.md`**      | Project glossary                     | Term clarification                      |
-| **`.parac/memory/logs/agent_actions.log`**     | Action history                       | Understanding changes                   |
-| **`.parac/memory/logs/decisions.log`**         | Important decisions                  | Context for choices                     |
-| **`.parac/roadmap/roadmap.yaml`**              | Roadmap and phases                   | Understanding priorities                |
-| **`.parac/roadmap/decisions.md`**              | ADRs (Architecture Decision Records) | Design rationale                        |
-| **`.parac/policies/CODE_STYLE.md`**            | Code style guide                     | Before coding                           |
-| **`.parac/policies/TESTING.md`**               | Testing policy                       | Before writing tests                    |
-| **`.parac/policies/SECURITY.md`**              | Security policy                      | Security-sensitive code                 |
-| **`content/docs/users/reference/api-keys.md`**         | **NEW: API key management guide**    | **Setting up LLM providers**            |
-| **`content/docs/technical/roadmap-state-sync.md`**     | **NEW: Roadmap sync guide**          | **Understanding governance automation** |
+| File | Purpose | When to Read |
+| --- | --- | --- |
+| **`.parac/GOVERNANCE.md`** | Governance rules, dogfooding context | ALWAYS first |
+| **`.parac/PRE_FLIGHT_CHECKLIST.md`** | **NEW: Mandatory task validation** | **Before ANY implementation** |
+| **`.parac/UNIVERSAL_AI_INSTRUCTIONS.md`** | Universal instructions (any IDE) | Setup / reference |
+| **`.parac/USING_PARAC.md`** | Complete 20+ section guide | Deep understanding |
+| **`.parac/CONFIG_FILES.md`** | project.yaml vs manifest.yaml | When confused about config |
+| **`.parac/STRUCTURE.md`** | Complete .parac/ structure | Understanding organization |
+| **`.parac/agents/manifest.yaml`** | Agent registry | Before selecting agent |
+| **`.parac/agents/specs/{agent}.md`** | Agent detailed specs | After selecting agent |
+| **`.parac/agents/SKILL_ASSIGNMENTS.md`** | Skills per agent | Understanding capabilities |
+| **`.parac/memory/context/current_state.yaml`** | Project state | ALWAYS (before action) |
+| **`.parac/memory/context/open_questions.md`** | Open questions | When blocked |
+| **`.parac/memory/knowledge/architecture.md`** | Architecture knowledge | Design decisions |
+| **`.parac/memory/knowledge/glossary.md`** | Project glossary | Term clarification |
+| **`.parac/memory/logs/agent_actions.log`** | Action history | Understanding changes |
+| **`.parac/memory/logs/decisions.log`** | Important decisions | Context for choices |
+| **`.parac/roadmap/roadmap.yaml`** | Roadmap and phases | Understanding priorities |
+| **`.parac/roadmap/decisions.md`** | ADRs (Architecture Decision Records) | Design rationale |
+| **`.parac/policies/CODE_STYLE.md`** | Code style guide | Before coding |
+| **`.parac/policies/TESTING.md`** | Testing policy | Before writing tests |
+| **`.parac/policies/SECURITY.md`** | Security policy | Security-sensitive code |
+| **`content/docs/api-keys.md`** | **NEW: API key management guide** | **Setting up LLM providers** |
+| **`content/docs/roadmap-state-sync.md`** | **NEW: Roadmap sync guide** | **Understanding governance automation** |
 
 
 
@@ -493,7 +458,7 @@ After action (MANDATORY):
 - **[.parac/GOVERNANCE.md](../.parac/GOVERNANCE.md)** - Governance rules
 - **[.parac/STRUCTURE.md](../.parac/STRUCTURE.md)** - Complete structure
 - **[.parac/agents/SKILL_ASSIGNMENTS.md](../.parac/agents/SKILL_ASSIGNMENTS.md)** - Skills per agent
-- **[content/docs/technical/architecture/overview.md](../content/docs/technical/architecture/overview.md)** - Technical architecture
+- **[content/docs/architecture.md](../content/docs/architecture.md)** - Technical architecture
 
 ---
 

diff --git a/.claude/settings.local.json b/.claude/settings.local.json
@@ -25,7 +25,8 @@
       "Bash(fi)",
       "Bash(dir \"c:\\\\Projets\\\\paracle\\\\paracle-lite\\\\content\\\\docs\\\\*.md\")",
       "Bash(dir:*)",
-      "Bash(go version:*)"
+      "Bash(go version:*)",
+      "Bash(chmod:*)"
     ]
   }
 }
diff --git a/.claude/skills/agent-configuration/SKILL.md b/.claude/skills/agent-configuration/SKILL.md
@@ -97,4 +97,4 @@ system_prompt: |
 ## Resources
 
 - Agent Specs: `.parac/agents/specs/`
-- Template: `content/templates/.parac-template/agents/specs/`
+- Template: `templates/.parac-template/agents/specs/`
diff --git a/.claude/skills/agent-configuration/assets/specialized-agent-template.yaml b/.claude/skills/agent-configuration/assets/specialized-agent-template.yaml
@@ -18,13 +18,13 @@ system_prompt: |
 
 # Add more skills
 skills:
-  - { { parent.skills } } # Include parent skills
+  - "{{parent.skills}}"  # Include parent skills (Jinja2 template)
   - specialized-skill-1
   - specialized-skill-2
 
 # Add more tools
 tools:
-  - { { parent.tools } } # Include parent tools
+  - "{{parent.tools}}"  # Include parent tools (Jinja2 template)
   - specialized-tool
 
 metadata:

diff --git a/.claude/skills/api-development/SKILL.md b/.claude/skills/api-development/SKILL.md
@@ -511,4 +511,4 @@ async def list_agents():
 - [FastAPI Documentation](https://fastapi.tiangolo.com/)
 - [Pydantic V2 Documentation](https://docs.pydantic.dev/)
 - [REST API Best Practices](https://restfulapi.net/)
-- Paracle API: `packages/paracle_api/`
+- Paracle API: `packages/paracle_api/`
diff --git a/.claude/skills/cicd-devops/SKILL.md b/.claude/skills/cicd-devops/SKILL.md
@@ -444,4 +444,4 @@ strategy:
 - [GitHub Actions Docs](https://docs.github.com/actions)
 - [Docker Best Practices](https://docs.docker.com/develop/dev-best-practices/)
 - [12-Factor App](https://12factor.net/)
-- Paracle CI/CD: `.github/workflows/`
+- Paracle CI/CD: `.github/workflows/`
diff --git a/.claude/skills/framework-architecture/SKILL.md b/.claude/skills/framework-architecture/SKILL.md
@@ -502,4 +502,4 @@ When designing new components:
 - [Clean Architecture by Robert C. Martin](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
 - [Domain-Driven Design](https://martinfowler.com/bliki/DomainDrivenDesign.html)
 - [ADR (Architecture Decision Records)](https://adr.github.io/)
-- [Python Design Patterns](https://refactoring.guru/design-patterns/python)
+- [Python Design Patterns](https://refactoring.guru/design-patterns/python)
diff --git a/.claude/skills/git-management/SKILL.md b/.claude/skills/git-management/SKILL.md
@@ -530,7 +530,7 @@ git commit -m "feat(providers): add MCP protocol support"
 git add tests/unit/providers/test_mcp.py
 git commit -m "test(providers): add MCP provider tests"
 
-git add content/docs/tools/mcp-integration.md
+git add docs/mcp-integration.md
 git commit -m "docs: add MCP integration guide"
 
 # Update with develop
@@ -666,4 +666,4 @@ git cherry-pick commit1^..commit2
 - [Paracle Git Workflow Policy](../../../policies/GIT_WORKFLOW.md)
 - [Conventional Commits](https://www.conventionalcommits.org/)
 - [Gitflow Workflow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow)
-- [Semantic Versioning](https://semver.org/)
+- [Semantic Versioning](https://semver.org/)
diff --git a/.claude/skills/migration-upgrading/SKILL.md b/.claude/skills/migration-upgrading/SKILL.md
@@ -338,4 +338,4 @@ paracle migrate --from 0.2.0 --to 0.3.0
 - Alembic: https://alembic.sqlalchemy.org/
 - Semantic Versioning: https://semver.org/
 - Migration Scripts: `packages/paracle_cli/commands/migrate.py`
-- CHANGELOG: `CHANGELOG.md`
+- CHANGELOG: `CHANGELOG.md`
diff --git a/.claude/skills/paracle-development/SKILL.md b/.claude/skills/paracle-development/SKILL.md
@@ -60,9 +60,9 @@ paracle-lite/
 │   ├── unit/
 │   ├── integration/
 │   └── conftest.py
-├── content/docs/             # Documentation
-├── content/examples/         # Usage examples
-├── content/templates/        # User templates
+├── docs/                     # Documentation
+├── examples/                 # Usage examples
+├── templates/                # User templates
 │   └── .parac-template/
 ├── pyproject.toml            # Project config
 ├── Makefile                  # Common tasks
@@ -449,7 +449,7 @@ from .web_search import WebSearchTool
 ToolRegistry.register(WebSearchTool())
 
 # 3. Add to template
-# content/templates/.parac-template/tools/registry.yaml
+# templates/.parac-template/tools/registry.yaml
 - name: web_search
   display_name: "Web Search"
   description: "Search the web for information"
@@ -641,4 +641,4 @@ def load_skill(skill_name: str) -> SkillSpec:
 - [Python Best Practices](https://docs.python-guide.org/)
 - [Pytest Documentation](https://docs.pytest.org/)
 - [Type Hints (PEP 484)](https://peps.python.org/pep-0484/)
-- [Conventional Commits](https://www.conventionalcommits.org/)
+- [Conventional Commits](https://www.conventionalcommits.org/)
diff --git a/.claude/skills/performance-optimization/SKILL.md b/.claude/skills/performance-optimization/SKILL.md
@@ -233,5 +233,5 @@ async def add_timing_header(request: Request, call_next):
 ## Resources
 
 - FastAPI Performance: https://fastapi.tiangolo.com/advanced/performance/
-- SQLAlchemy Optimization: `content/docs/technical/performance-guide.md`
-- Monitoring: `packages/paracle_core/logging/metrics.py`
+- SQLAlchemy Optimization: `docs/performance-guide.md`
+- Monitoring: `packages/paracle_core/logging/metrics.py`
diff --git a/.claude/skills/performance-optimization/references/OPTIMIZATION_PATTERNS.md b/.claude/skills/performance-optimization/references/OPTIMIZATION_PATTERNS.md
@@ -372,4 +372,4 @@ def memory_intensive_function():
 
 - `SKILL.md` for quick optimization patterns
 - `scripts/profile_api.py` for endpoint profiling
-- `content/docs/technical/performance-guide.md` for detailed guidelines
+- `docs/performance-guide.md` for detailed guidelines
diff --git a/.claude/skills/provider-integration/SKILL.md b/.claude/skills/provider-integration/SKILL.md
@@ -141,4 +141,4 @@ class CustomProvider(Provider):
 ## Resources
 
 - Providers: `packages/paracle_providers/`
-- Configuration: `.parac/providers/providers.yaml`
+- Configuration: `.parac/providers/providers.yaml`