aios-core 2.1.0

package/.aios-core/product/templates/personalized-task-template.md

@@ -0,0 +1,344 @@
+# {Task Name}
+
+## Purpose
+
+{Brief description of what this task does and when to use it}
+
+---
+
+## Parameters
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `{param1}` | Yes | - | {Description} |
+| `{param2}` | No | `{default}` | {Description} |
+
+---
+
+## Workflow
+
+### Step 1: {Step Name}
+
+{Step description}
+
+**Actions:**
+1. {Action 1}
+2. {Action 2}
+3. {Action 3}
+
+**Validation:**
+- {Validation check 1}
+- {Validation check 2}
+
+**Output Format (STANDARDIZED):**
+```markdown
+## 📊 Task Execution Report
+
+**Agent:** {agent.name} ({agent.persona_profile.archetype})
+**Task:** {task.name}
+**Started:** {timestamp.start}
+**Completed:** {timestamp.end}
+**Duration:** {duration}
+**Tokens Used:** {tokens.input} in / {tokens.output} out / {tokens.total} total
+
+---
+
+### Status
+{PERSONALITY_SLOT: status_message}
+
+**Examples per archetype:**
+- **Builder (Dex):** "✅ Tá pronto! Implementei todas as funcionalidades."
+- **Guardian (Quinn):** "✅ Validado com rigor. 47 edge cases testados."
+- **Balancer (Pax):** "✅ Story completa. Equilibrei performance vs. legibilidade."
+
+### Output
+{step_specific_output}
+
+### Metrics
+- Tests: {tests.passed}/{tests.total}
+- Coverage: {coverage}%
+- Linting: {lint.status}
+- {task_specific_metric_1}: {value}
+- {task_specific_metric_2}: {value}
+
+---
+{PERSONALITY_SLOT: agent.signature_closing}
+```
+
+### Step 2: {Step Name}
+
+{Continue with additional steps...}
+
+---
+
+## Elicitation (if applicable)
+
+**When:** {When to elicit user input}
+
+**Format:**
+```markdown
+{Agent greeting using personality}
+
+{Question or choice}
+
+Options:
+1. {Option 1}
+2. {Option 2}
+3. {Option 3}
+
+{Personality-infused guidance based on archetype}
+```
+
+**Example:**
+```markdown
+💻 Dex (Builder): Preciso saber qual approach você prefere.
+
+Escolha a arquitetura:
+1. Microservices (mais escalável, maior complexidade)
+2. Monolith (mais simples, menos overhead)
+3. Modular Monolith (meio termo)
+
+Eu recomendo #3 pra começar - facilita construir rápido e depois separar se necessário.
+```
+
+---
+
+## Success Criteria
+
+- [ ] {Criterion 1}
+- [ ] {Criterion 2}
+- [ ] Output follows standardized template
+- [ ] All metrics calculated and displayed
+- [ ] Duration and token usage tracked
+
+---
+
+## Error Handling
+
+### Error: {Error Type}
+
+**Detection:**
+{How to detect this error}
+
+**Resolution:**
+{How to resolve it}
+
+**Personalized Error Message Examples:**
+- **Builder:** "⚠️ Build falhou. Vou debugar e reconstruir."
+- **Guardian:** "⚠️ Validação falhou. Bloqueando deploy até resolução."
+- **Balancer:** "⚠️ Conflito detectado. Vou mediar e encontrar consenso."
+
+---
+
+## Dependencies
+
+**Tasks:**
+- `.aios-core/tasks/{dependency1}.md`
+- `.aios-core/tasks/{dependency2}.md`
+
+**Templates:**
+- `.aios-core/product/templates/{template1}.yaml`
+
+**Checklists:**
+- `.aios-core/product/checklists/{checklist1}.md`
+
+**Tools:**
+- `{tool1}` - {Usage description}
+- `{tool2}` - {Usage description}
+
+---
+
+## Output Templates
+
+### Standard Task Report
+
+All task outputs MUST use this structure (see `.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md`):
+
+**FIXED SECTIONS (never change order):**
+1. Header (lines 1-7: Agent, Task, Timestamps, Duration, Tokens)
+2. Status (personality slot)
+3. Output (task-specific content)
+4. Metrics (always last)
+5. Signature (personality slot)
+
+**PERSONALITY SLOTS (varies per agent):**
+- Status message (line after "### Status")
+- Signature closing (last line)
+- Emoji selection (from archetype palette)
+- Verb choice (from agent vocabulary)
+
+### Metric Tracking
+
+**Required metrics (all tasks):**
+```javascript
+{
+  duration: "2.3s",           // Execution time
+  tokens: {
+    input: 1234,              // Input tokens consumed
+    output: 567,              // Output tokens generated
+    total: 1801               // Total tokens
+  },
+  tests: {
+    passed: 12,               // Tests that passed
+    total: 12,                // Total tests run
+    status: "✅ All passing"  // Status summary
+  },
+  coverage: 87,               // Code coverage %
+  lint: {
+    status: "✅ Clean",       // Linting status
+    warnings: 0,              // Warning count
+    errors: 0                 // Error count
+  }
+}
+```
+
+**Optional task-specific metrics:**
+```javascript
+{
+  // Add metrics relevant to this specific task
+  files_modified: 5,
+  dependencies_added: 2,
+  breaking_changes: 0,
+  // etc.
+}
+```
+
+---
+
+## Personality Configuration
+
+### Agent Behavior During Task
+
+**Tone consistency:**
+- Use agent's vocabulary words from `persona_profile.communication.vocabulary`
+- Match agent's tone from `persona_profile.communication.tone`
+- Select emojis from archetype palette (see `archetype-vocabulary.yaml`)
+
+**Example vocabulary usage:**
+```javascript
+// Builder agent (Dex)
+vocabulary: ["construir", "implementar", "refatorar"]
+status_message: "✅ Tá pronto! Implementei todas as funcionalidades."
+
+// Guardian agent (Quinn)
+vocabulary: ["validar", "verificar", "garantir"]
+status_message: "✅ Validado. Garanti cobertura em todos os edge cases."
+```
+
+### Status Message Generation
+
+**Template:**
+```
+{status_icon} {verb_from_vocabulary} {accomplishment}!
+```
+
+**Examples by archetype:**
+
+| Archetype | Verb | Example Message |
+|-----------|------|-----------------|
+| Builder | construir, implementar | "✅ Implementei com sucesso. 3 componentes criados." |
+| Guardian | validar, garantir | "✅ Validado rigorosamente. Zero vulnerabilidades." |
+| Balancer | equilibrar, harmonizar | "✅ Harmonizei as dependências. Tudo alinhado." |
+| Visionary | planejar, estrategizar | "✅ Estratégia definida. 5 milestones mapeados." |
+
+---
+
+## Testing
+
+### Unit Test Template
+
+```javascript
+// tests/tasks/{task-name}.test.js
+
+describe('{Task Name}', () => {
+  it('should generate standardized output', () => {
+    const agent = loadAgent('dev');
+    const result = executeTask('{task-name}', params);
+
+    // Validate fixed structure
+    expect(result).toContain('## 📊 Task Execution Report');
+    expect(result).toContain('**Duration:**');
+    expect(result).toContain('**Tokens Used:**');
+    expect(result).toContain('### Status');
+    expect(result).toContain('### Metrics');
+
+    // Validate personality injection
+    expect(result).toContain(agent.persona_profile.signature_closing);
+  });
+
+  it('should track duration and tokens', () => {
+    const result = executeTask('{task-name}', params);
+
+    expect(result.metrics.duration).toBeDefined();
+    expect(result.metrics.tokens.total).toBeGreaterThan(0);
+  });
+
+  it('should use agent vocabulary in status message', () => {
+    const agent = loadAgent('dev');
+    const result = executeTask('{task-name}', params);
+
+    const hasVocabularyWord = agent.persona_profile.communication.vocabulary
+      .some(word => result.status_message.includes(word));
+
+    expect(hasVocabularyWord).toBe(true);
+  });
+});
+```
+
+---
+
+## Examples
+
+### Example 1: {Example Scenario}
+
+**Input:**
+```yaml
+task: {task-name}
+agent: dev
+params:
+  {param1}: {value1}
+  {param2}: {value2}
+```
+
+**Output:**
+```markdown
+## 📊 Task Execution Report
+
+**Agent:** Dex (Builder)
+**Task:** {Task Name}
+**Started:** 2025-01-14T10:30:00Z
+**Completed:** 2025-01-14T10:32:23Z
+**Duration:** 2.3s
+**Tokens Used:** 1,234 in / 567 out / 1,801 total
+
+---
+
+### Status
+✅ Tá pronto! Implementei com sucesso.
+
+### Output
+{Task-specific output here}
+
+### Metrics
+- Tests: 12/12
+- Coverage: 87%
+- Linting: ✅ Clean
+
+---
+— Dex, sempre construindo 🔨
+```
+
+---
+
+## Notes
+
+- **CRITICAL:** Always follow output template structure (familiaridade = produtividade)
+- **CRITICAL:** Track duration and tokens for all task executions
+- **CRITICAL:** Use agent's vocabulary and tone consistently
+- See `.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md` for complete guidelines
+
+---
+
+**Template Version:** 1.0
+**Last Updated:** 2025-01-14
+**Applies to:** All tasks using personalized agents (Story 6.1.2+)

package/.aios-core/product/templates/personalized-template-file.yaml

@@ -0,0 +1,322 @@
+# Template File Structure for AIOS-FULLSTACK
+# This YAML defines output templates that agents use to generate consistent documents
+# Version: 1.0 (Story 6.1.2 - Personalized Agents)
+
+template:
+  name: {TemplateName}
+  id: {template-id}
+  description: {Brief description of what this template generates}
+  version: "1.0"
+
+  # When to use this template
+  usage:
+    when: {When to use this template}
+    agents: [{agent1}, {agent2}]  # Which agents typically use this
+
+  # Personality configuration
+  personality:
+    supports_personalization: true  # Can agents inject personality?
+    personality_slots:              # Where personality can be injected
+      - section: {section_name}
+        field: {field_name}
+        type: {text|emoji|vocabulary}
+
+    fixed_structure: true           # Structure must not change
+    fixed_sections:                 # Sections that are always the same
+      - {section1}
+      - {section2}
+
+# Document metadata (standardized across all outputs)
+metadata:
+  agent: "{agent.name} ({agent.persona_profile.archetype})"
+  generated_at: "{timestamp}"
+  duration: "{duration}"
+  tokens_used: "{tokens.total} total"
+  template_version: "{template.version}"
+
+# Document structure (FIXED POSITIONS for familiaridade)
+structure:
+  # Section 1: Header (ALWAYS FIRST)
+  header:
+    format: markdown
+    required: true
+    content: |
+      # {DocumentTitle}
+
+      **Generated by:** {agent.name} ({agent.persona_profile.archetype})
+      **Date:** {timestamp}
+      **Version:** {document.version}
+
+  # Section 2: Executive Summary (ALWAYS SECOND)
+  summary:
+    format: markdown
+    required: true
+    personality_slot: greeting  # Agent can personalize this
+    content: |
+      ## Executive Summary
+
+      {PERSONALITY_SLOT: Agent introduces document in their voice}
+
+      **Examples by archetype:**
+      - **Builder (Dex):** "Construí este documento para mapear a arquitetura. Vamos direto ao ponto."
+      - **Guardian (Quinn):** "Validei todos os requisitos antes de gerar este documento. Tudo verificado."
+      - **Balancer (Pax):** "Este documento equilibra visão técnica e necessidades de negócio."
+
+      {summary_content}
+
+  # Section 3: Main Content (VARIES BY TEMPLATE TYPE)
+  content:
+    format: markdown
+    required: true
+    subsections:
+      - name: {subsection1_name}
+        required: {true|false}
+        content: |
+          {subsection1_content}
+
+      - name: {subsection2_name}
+        required: {true|false}
+        personality_slot: {slot_name}  # Optional personality injection
+        content: |
+          {subsection2_content}
+
+  # Section 4: Metrics & Validation (ALWAYS BEFORE FOOTER)
+  metrics:
+    format: markdown
+    required: true
+    content: |
+      ## Validation Metrics
+
+      - **Duration:** {duration}
+      - **Tokens Used:** {tokens.total} total
+      - **Sections:** {sections.completed}/{sections.total}
+      - **Completeness:** {completeness}%
+
+  # Section 5: Footer (ALWAYS LAST)
+  footer:
+    format: markdown
+    required: true
+    personality_slot: signature  # Agent signature
+    content: |
+      ---
+
+      **Generated by:** {agent.name} ({agent.persona_profile.archetype})
+      **Template:** {template.name} v{template.version}
+
+      {PERSONALITY_SLOT: agent.signature_closing}
+
+# Field definitions (data structure for template)
+fields:
+  # Required fields (must be provided)
+  required:
+    - name: {field1_name}
+      type: {string|number|boolean|array|object}
+      description: {Field description}
+      validation:
+        min_length: {number}      # For strings
+        max_length: {number}      # For strings
+        pattern: {regex}          # For validation
+
+    - name: {field2_name}
+      type: {type}
+      description: {Description}
+
+  # Optional fields (have defaults)
+  optional:
+    - name: {field3_name}
+      type: {type}
+      default: {default_value}
+      description: {Description}
+
+# Personality configuration for this template
+personality_configuration:
+  # Vocabulary guidance for this document type
+  recommended_vocabulary:
+    Builder: [construir, implementar, arquitetar, estruturar]
+    Guardian: [validar, proteger, garantir, verificar]
+    Balancer: [equilibrar, harmonizar, alinhar, integrar]
+    Visionary: [planejar, estrategizar, projetar, antecipar]
+
+  # Tone guidance for this document type
+  recommended_tone:
+    formal_document: analytical    # PRDs, architecture docs
+    user_facing: empathetic       # User guides, onboarding
+    technical: pragmatic          # Technical specs, API docs
+    strategic: collaborative      # Roadmaps, planning docs
+
+  # Emoji usage guidance
+  emoji_usage:
+    frequency: {minimal|low|medium|high}
+    allowed_contexts: [{header}, {status}, {celebration}]
+    archetype_palettes: true  # Use archetype-specific emoji palettes
+
+# Output formatting (standardization rules)
+formatting:
+  # Markdown style
+  markdown:
+    heading_style: atx           # # Heading (not underline style)
+    list_style: dash             # - Item (not * or +)
+    code_fence: backticks        # ``` (not ~~~)
+    emphasis: asterisk           # *italic* **bold**
+
+  # Structure consistency
+  consistency:
+    section_spacing: 2           # Blank lines between sections
+    subsection_spacing: 1        # Blank lines between subsections
+    list_spacing: 0              # No blank lines in lists
+
+  # Fixed positions (familiaridade requirement)
+  fixed_positions:
+    metadata: "lines 1-5"        # Always at top
+    summary: "after metadata"    # Always second
+    metrics: "before footer"     # Always second-to-last
+    signature: "last line"       # Always last
+
+# Validation rules
+validation:
+  # Structure validation
+  structure:
+    - rule: header_present
+      message: "Header section required"
+
+    - rule: sections_ordered
+      message: "Sections must follow template order"
+
+    - rule: metrics_before_footer
+      message: "Metrics section must be before footer"
+
+  # Content validation
+  content:
+    - rule: all_required_fields_present
+      message: "All required fields must be provided"
+
+    - rule: personality_slots_filled
+      message: "All personality slots must be populated"
+
+  # Personality validation
+  personality:
+    - rule: uses_agent_vocabulary
+      message: "Should use words from agent's vocabulary list"
+
+    - rule: matches_agent_tone
+      message: "Tone should match agent's persona_profile.communication.tone"
+
+    - rule: signature_present
+      message: "Agent signature_closing required in footer"
+
+# Examples (for documentation)
+examples:
+  - name: {Example 1 Name}
+    agent: dev
+    description: {What this example demonstrates}
+    input:
+      {field1}: {value1}
+      {field2}: {value2}
+    output: |
+      {Generated document content}
+
+  - name: {Example 2 Name}
+    agent: qa
+    description: {What this example demonstrates}
+    input:
+      {field1}: {value1}
+    output: |
+      {Generated document content}
+
+# Change log
+changelog:
+  - version: "1.0"
+    date: "2025-01-14"
+    changes:
+      - Added persona_profile support
+      - Standardized metrics section
+      - Added personality slots
+      - Fixed section positions for familiaridade
+
+# Related documents
+related:
+  standard: docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md
+  agents:
+    - .aios-core/agents/{agent1}.md
+    - .aios-core/agents/{agent2}.md
+  tasks:
+    - .aios-core/tasks/{task1}.md
+  templates:
+    - .aios-core/product/templates/{related-template}.yaml
+
+---
+
+# USAGE GUIDE
+
+## How Agents Use This Template
+
+1. **Load Template:**
+   ```javascript
+   const template = loadTemplate('{template-id}');
+   ```
+
+2. **Populate Fields:**
+   ```javascript
+   const data = {
+     {field1}: value1,
+     {field2}: value2,
+     agent: currentAgent,
+     timestamp: new Date().toISOString()
+   };
+   ```
+
+3. **Inject Personality:**
+   ```javascript
+   const personalizedContent = injectPersonality(
+     template,
+     currentAgent.persona_profile,
+     data
+   );
+   ```
+
+4. **Validate Output:**
+   ```javascript
+   const validation = validateTemplate(personalizedContent, template);
+   if (!validation.valid) {
+     throw new Error(validation.errors);
+   }
+   ```
+
+5. **Generate Document:**
+   ```javascript
+   const document = renderTemplate(personalizedContent);
+   saveDocument(document);
+   ```
+
+## Personality Injection
+
+**Where personality shows:**
+- Greeting/introduction in summary
+- Recommendations and guidance
+- Status messages
+- Signature closing
+
+**Where personality NEVER shows:**
+- Section order
+- Metric positions
+- Required field labels
+- Validation rules
+
+## Validation Checklist
+
+Before committing template file:
+
+- [ ] All required fields defined
+- [ ] Section order matches standard
+- [ ] Metrics section before footer
+- [ ] Personality slots identified
+- [ ] Formatting rules specified
+- [ ] Examples provided
+- [ ] Validation rules complete
+- [ ] Related documents linked
+
+---
+
+**Template File Version:** 1.0
+**Last Updated:** 2025-01-14
+**Applies to:** Story 6.1.2+ (Personalized Agents)