arkaos 2.17.1 → 2.17.4

package/VERSION

@@ -1 +1 @@
-2.17.1
+2.17.4

package/arka/SKILL.md

@@ -47,23 +47,10 @@ Users don't need to memorize commands. Just describe what you need:
 
 ### Routing Logic
 
-```
-1. Check for explicit /prefix command → Route directly
-
-2. If no prefix (natural language):
-   a. Synapse L1 (Department Detection) matches keywords
-   b. Synapse L5 (Command Hints) scores against registry
-   c. Hook context [dept:], [hint:] tags from Synapse
-
-3. Resolution:
-   - Single high-confidence match → Announce squad + execute
-   - Multiple matches → Show top 3, ask user to pick
-   - No match but clear department → Route to /dept do
-   - Ambiguous → Ask "Which department?"
-
-4. Code-modifying commands → Show preview, ask confirmation
-   Non-code commands → Auto-execute with announcement
-```
+1. Explicit `/prefix` → Route directly
+2. Natural language → Synapse L1 (keyword) + L5 (command hints) + hook context tags
+3. Resolution: single match → announce + execute | multiple → top 3 + ask | ambiguous → ask department
+4. Code-modifying → preview + confirm | non-code → auto-execute
 
 ### Squad Routing (NON-NEGOTIABLE)
 
@@ -72,24 +59,7 @@ as a generic assistant. Even a one-line task goes through the correct squad work
 
 ## Department Routing Table
 
-| Prefix | Department | Lead Agent | Commands |
-|--------|-----------|------------|----------|
-| `/dev` | Development | Paulo (Tech Lead) | 16 |
-| `/mkt` | Marketing & Growth | Luna | 12 |
-| `/brand` | Brand & Design | Valentina | 12 |
-| `/fin` | Finance & Investment | Helena (CFO) | 10 |
-| `/strat` | Strategy & Innovation | Tomas | 10 |
-| `/ecom` | E-Commerce | Ricardo | 12 |
-| `/kb` | Knowledge Management | Clara | 12 |
-| `/ops` | Operations & Automation | Daniel | 10 |
-| `/pm` | Project Management | Carolina | 12 |
-| `/saas` | SaaS & Micro-SaaS | Tiago | 14 |
-| `/landing` | Landing Pages & Funnels | Ines | 14 |
-| `/content` | Content & Viralization | Rafael | 14 |
-| `/community` | Communities & Groups | Beatriz | 14 |
-| `/sales` | Sales & Negotiation | Miguel | 10 |
-| `/lead` | Leadership & People | Rodrigo | 10 |
-| `/org` | Organization & Teams | Sofia (COO) | 10 |
+`/dev` Paulo · `/mkt` Luna · `/brand` Valentina · `/fin` Helena · `/strat` Tomas · `/ecom` Ricardo · `/kb` Clara · `/ops` Daniel · `/pm` Carolina · `/saas` Tiago · `/landing` Ines · `/content` Rafael · `/community` Beatriz · `/sales` Miguel · `/lead` Rodrigo · `/org` Sofia (COO)
 
 ## Quality Gate (Automatic)
 
@@ -110,44 +80,16 @@ Every workflow includes a Quality Gate phase before delivery:
 
 ## Cross-Department Collaboration
 
-ArkaOS supports matrix structure: agents belong to department squads but can be
-borrowed into ad-hoc project squads. Example:
-
-```
-/do "launch campaign for new product"
-→ Creates project squad with:
-   - Ines (Landing) — offer + funnel
-   - Teresa (Landing) — sales copy
-   - Luna (Marketing) — paid + social
-   - Isabel (Brand) — visual assets
-   - Ricardo (E-Commerce) — store setup
-```
+Matrix structure: agents belong to department squads but can be borrowed into ad-hoc project squads. Example: `/do "launch campaign"` → Ines (Landing) + Luna (Marketing) + Isabel (Brand) + Ricardo (E-Commerce).
 
 ## Session Greeting
 
-On first interaction (no command provided):
-1. Read user profile from ~/.arkaos/profile.json
-2. If profile exists: Show branded welcome with name and company
-3. If no profile: Prompt onboarding via /arka setup
-4. If command provided: Skip greeting, process immediately
+No command: read `~/.arkaos/profile.json` → welcome if exists, else `/arka setup`. Command provided → process immediately.
 
 ## Obsidian Integration
 
-All department output saved to the Obsidian vault:
-- YAML frontmatter on all files
-- Wikilinks for cross-references
-- Department-specific output paths
-- MOC (Map of Content) for organization
+All output: YAML frontmatter · wikilinks · department paths · MOC organization.
 
 ## Model Selection
 
-When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
-
-- Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
-- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
-- Default to `sonnet` if the agent YAML has no `model` field
-- Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
-
-Example Task tool call:
-
-    Task(description="...", subagent_type="general-purpose", model="sonnet", prompt="...")
+Use `model` parameter from agent YAML (`departments/*/agents/*.yaml`). Quality Gate (Marta/Eduardo/Francisca) ALWAYS `model: opus` — NON-NEGOTIABLE. Default: `sonnet`. Mechanical tasks: `haiku`.

package/arka/skills/comfyui/SKILL.md

@@ -22,14 +22,12 @@ Full-spectrum AI media production platform. From ComfyUI node engineering to Hol
 | **purz-comfyui-workflows** | Workflow Collection | ComfyUI JSON (7 workflows, 110+ nodes) | `/Users/andreagroferreira/AIProjects/purz-comfyui-workflows` |
 | **lora_tester** | CLI Tool + Gallery | Python 3.8+ (stdlib) + Vanilla HTML/JS | `/Users/andreagroferreira/AIProjects/lora_tester` |
 
-## Squads (summary)
+## Squads
 
-| Squad | Purpose | Members |
-|-------|---------|---------|
-| **ComfyUI Core** | Technical engine: workflow JSON, custom nodes, models, VRAM, API automation | Viktor (Pipeline Architect), Kaito (Workflow Engineer), Iris (Node Researcher), Atlas (Model Specialist), Nexus (Automation Engineer), Pixel (QA Tester) |
-| **Cinematographic Production** | Hollywood pipeline: direction, DP, art, VFX, color, edit, sound, motion, production | Roman (Director), Lena (DP), Soren (Screenwriter), Mika (Art Director), Orion (VFX), Celeste (Colorist), Raven (Editor), Echo (Sound Designer), Flux (Motion Graphics), Sterling (Producer) |
+**ComfyUI Core:** Viktor, Kaito, Iris, Atlas, Nexus, Pixel — workflow JSON, custom nodes, models, VRAM, API.
+**Cinematographic Production:** Roman, Lena, Soren, Mika, Orion, Celeste, Raven, Echo, Flux, Sterling — direction, DP, VFX, color, edit, sound, motion.
 
-Full role definitions, agent types, and competencies: `references/squads.md`.
+Full role definitions: `references/squads.md`.
 
 ## Commands
 
@@ -70,13 +68,53 @@ Full role definitions, agent types, and competencies: `references/squads.md`.
 
 ## Orchestration Workflow
 
-Every `/comfyui` request follows a 6-phase flow: (1) context loading, (2) analysis & planning with squad routing, (3) plan presentation & approval gate, (4) execution with worktree isolation, (5) mandatory Quality Gate (Marta/Eduardo/Francisca), (6) documentation & report.
+6-phase flow: context → analysis+squad routing → plan approval → execution (worktree) → Quality Gate → docs. Squad: technical → Core; creative → Cinematographic; full → both (Sterling coords); research → Iris/Atlas. Details: `references/workflows.md`
 
-Squad routing: technical → Core; creative production → Cinematographic; full production → both, coordinated by Producer Sterling; research → Iris or Atlas.
+<!-- arka:feature:forge-integration:start -->
+## Forge Integration
 
-**See `references/workflows.md`** for full phase templates (plan, report), workflows catalogue (LTX-2 T2V/I2V/Audio, SVD, AnimateDiff), model registry, cinematic prompt engineering guide, ComfyUI API reference, status command, `/comfyui produce` pipeline, custom node research protocol, and Obsidian output structure.
+Complex requests (complexity score >= 5) are automatically routed to
+The Forge for multi-agent planning before execution.
 
-## References
+- Phase 0.5: Forge analysis (after spec creation, before squad planning)
+- Complexity assessment: automatic via Synapse L8 (ForgeContextLayer)
+- Manual invocation: `/forge` command
+- Handoff: Forge outputs structured plan -> squad executes phases
+<!-- arka:feature:forge-integration:end -->
 
-- `references/squads.md` — Full Core and Cinematographic squad role tables, agent types, core competencies
-- `references/workflows.md` — Phase templates, workflow catalogue, model registry, API reference, prompt engineering guide, Obsidian output
+<!-- arka:feature:quality-gate:start -->
+## Quality Gate
+
+Mandatory on every workflow. Nothing ships without approval.
+
+- **Marta (CQO):** Orchestrates review, absolute veto power
+- **Eduardo (Copy Director):** Reviews all text output
+- **Francisca (Tech Director):** Reviews all code and technical output
+- Verdict: APPROVED or REJECTED (binary, no partial)
+<!-- arka:feature:quality-gate:end -->
+
+<!-- arka:feature:spec-driven-gate:start -->
+## Spec-Driven Development
+
+Phase 0 of all workflows. No implementation begins without a validated spec.
+
+- Invocation: automatic before any feature/fix work
+- Gate: spec must be approved before planning phase starts
+- Storage: `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`
+- Review: user approval required on written spec
+<!-- arka:feature:spec-driven-gate:end -->
+
+<!-- arka:feature:workflow-tiers:start -->
+## Workflow Tiers
+
+Three workflow tiers based on task complexity:
+
+| Tier | Phases | When |
+|------|--------|------|
+| Enterprise | 7-10 phases | Complex features, multi-file changes |
+| Focused | 3-5 phases | Medium tasks, single-domain changes |
+| Specialist | 1-2 phases | Simple tasks, quick fixes |
+
+Tier selection is automatic based on complexity assessment.
+Quality Gate phase is mandatory on ALL tiers.
+<!-- arka:feature:workflow-tiers:end -->

package/arka/skills/conclave/SKILL.md

@@ -9,186 +9,88 @@ allowed-tools: [Read, Write, Edit, Bash, Agent, AskUserQuestion]
 
 # The Conclave — `/arka conclave`
 
-> Your personal board of AI advisors. Each one based on a real person,
-> with codified mental models, thinking styles, and decision frameworks.
+Your personal board of AI advisors. Each based on a real person with codified mental models, thinking styles, and decision frameworks.
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/arka conclave` | Start profiling (first time) or view your board |
-| `/arka conclave profile` | Re-run the 17-question DNA profiling |
+| `/arka conclave` | Start profiling (first time) or view board |
+| `/arka conclave profile` | Re-run 17-question DNA profiling |
 | `/arka conclave view` | Display your current advisory board |
 | `/arka conclave ask "<question>"` | Ask all 10 advisors a question |
 | `/arka conclave advisor <name>` | Deep dive on one advisor's mental models |
-| `/arka conclave debate "<topic>"` | Watch your advisors debate a topic |
+| `/arka conclave debate "<topic>"` | Watch advisors debate a topic |
 | `/arka conclave aligned` | Show only your 5 aligned advisors |
 | `/arka conclave contrarian` | Show only your 5 contrarian advisors |
 
 ## First Run: DNA Profiling
 
-When the user runs `/arka conclave` for the first time (no profile exists):
+When `/arka conclave` runs first time (no profile):
 
-### Step 1: Welcome
-```
-Welcome to The Conclave — your personal AI advisory board.
-
-I'll ask you 17 questions to understand how you think, decide, and lead.
-This takes about 5 minutes. Your answers determine which advisors match
-your thinking style and which ones will challenge your blind spots.
-
-Ready? Let's begin.
-```
-
-### Step 2: Ask Questions (one at a time)
-
-Use AskUserQuestion tool for each question. Present the options clearly.
-Group by framework with brief context:
-
-**Questions 1-4: How you ACT (DISC)**
-- These reveal your behavioral style in work situations
-
-**Questions 5-8: What DRIVES you (Enneagram)**
-- These reveal your core motivations and fears
+**Step 1: Welcome** — explain 5-min profiling, ask if ready.
 
-**Questions 9-13: Your TRAITS (Big Five)**
-- These reveal your personality on 5 continuous scales
+**Step 2: Ask 17 Questions** — one at a time via `AskUserQuestion`:
 
-**Questions 14-17: How you THINK (MBTI)**
-- These reveal how you process information and decide
+| # | Framework | Reveals |
+|---|-----------|---------|
+| 1-4 | DISC | How you ACT in work situations |
+| 5-8 | Enneagram | What DRIVES you (core motivations/fears) |
+| 9-13 | Big Five | Your personality on 5 continuous scales |
+| 14-17 | MBTI | How you THINK and process decisions |
 
-### Step 3: Score and Build Profile
-
-After all 17 answers:
+**Step 3: Score and Build Profile**
 
 1. Load `core.conclave.profiler` module
 2. Create `ProfilingSession`, process each answer
-3. Call `build_profile_from_session()` to get `UserProfile`
-4. Call `match_advisors()` to assemble the board
-5. Save profile to `~/.arkaos/conclave-profile.json`
-
-### Step 4: Present the Board
-
-Display the board using this format:
-
-```markdown
-## Your Behavioral DNA
-
-| Framework | Result | Meaning |
-|-----------|--------|---------|
-| DISC | D+C (Driver-Analyst) | Direct, data-driven, results-focused |
-| Enneagram | 5w6 (The Investigator) | Seeks competence, fears being incapable |
-| Big Five | O:78 C:85 E:35 A:40 N:25 | Curious, disciplined, introverted, direct, calm |
-| MBTI | INTJ (The Architect) | Strategic vision + efficient execution |
-
-## Your Advisory Board
-
-### ALIGNED — Think Like You (amplify your strengths)
-
-**1. Charlie Munger** — Vice Chairman, Berkshire Hathaway
-   Match: 96% | DNA: C+D, 5w6, ISTJ
-   Models: Inversion, Latticework, Circle of Competence
-   "What's the downside? Am I treating the symptom or the disease?"
+3. Call `build_profile_from_session()` → `UserProfile`
+4. Call `match_advisors()` → assemble the board
+5. Save to `~/.arkaos/conclave-profile.json`
 
-**2. Ray Dalio** — Founder, Bridgewater Associates
-   Match: 94% | DNA: D+C, 5w6, INTJ
-   Models: Principles-Based Decisions, Radical Transparency
-   "What is the principle? Is this based on data or opinion?"
-
-[... 3 more aligned ...]
-
-### CONTRARIAN — Challenge Your Blind Spots
-
-**1. Simon Sinek** — Author, Start With Why
-   Match: 35% | DNA: I+S, 2w1, ENFJ
-   Challenge: You focus on WHAT and HOW. Simon forces you to ask WHY.
-   "What's the WHY? Will people follow because they want to?"
-
-**2. Brene Brown** — Research Professor
-   Match: 38% | DNA: I+S, 4w3, ENFP
-   Challenge: You value control and competence. Brene values vulnerability.
-   "Am I being brave enough to be vulnerable?"
-
-[... 3 more contrarian ...]
-```
+**Step 4: Present the Board** — show user's DNA (DISC, Enneagram, Big Five, MBTI) + 5 aligned + 5 contrarian advisors with match %, mental models, and signature questions.
 
 ## Ask Command: `/arka conclave ask "<question>"`
 
-When the user asks a question to the board:
-
-1. Load the saved ConclaveBoard
-2. For each of the 10 advisors, generate a response **in character**:
-   - Use the advisor's communication style
-   - Apply their mental models to the question
-   - Ask their key questions
-   - Keep each response to 3-5 sentences
-3. Present aligned responses first, then contrarian
-4. End with a synthesis: "Where they agree, where they disagree, and what you should consider"
-
-### Advisor Response Template
+1. Load `~/.arkaos/conclave-profile.json`
+2. For each of 10 advisors, generate response **in character** (3-5 sentences, their mental models, their questions)
+3. Aligned first, then contrarian
+4. End with synthesis: where they agree/disagree + what to consider
 
-For each advisor, use this system prompt approach:
+**System prompt approach per advisor:**
 
 ```
-You are {name}, {title}. You think using these mental models:
-{mental_models}
-
-Your communication style: {communication_style}
-Your decision framework: {decision_framework}
-
-When asked a question, respond in 3-5 sentences as {name} would.
-Use your mental models. Ask your key questions. Be specific to THIS situation.
-Do NOT be generic. Channel {name}'s actual thinking.
+You are {name}, {title}. You think using: {mental_models}.
+Your style: {communication_style}. Your framework: {decision_framework}.
+Respond in 3-5 sentences as {name} would. Be specific. Channel their actual thinking.
 ```
 
 ## Advisor Deep Dive: `/arka conclave advisor <name>`
 
-Show the full advisor profile:
-- Behavioral DNA (all 4 frameworks)
-- All mental models with descriptions and key questions
-- Communication style
-- Decision framework
-- Sources (books, talks)
-- Why they were matched (aligned or contrarian, score, dimension comparison)
+Full advisor profile: all 4 DNA frameworks, mental models with key questions, communication style, decision framework, sources, why matched (aligned/contrarian, score, dimension comparison).
 
 ## Debate: `/arka conclave debate "<topic>"`
 
-1. Present the topic to all 10 advisors
-2. Each advisor gives their 2-3 sentence take
+1. Present topic to all 10 advisors
+2. Each gives 2-3 sentence take
 3. Identify disagreements between aligned and contrarian groups
-4. Present the debate as a structured discussion:
-   - Opening positions (each advisor)
-   - Key disagreements (which advisors clash and why)
-   - Synthesis (what the user should take from both sides)
+4. Structured output: opening positions → key disagreements → synthesis
 
 ## Profile Persistence
 
-- Save: `~/.arkaos/conclave-profile.json`
-- Contains: UserProfile (DNA) + ConclaveBoard (matched advisors)
+- Profile: `~/.arkaos/conclave-profile.json`
 - Re-profile: `/arka conclave profile` overwrites existing
-- Profile is loaded automatically on subsequent `/arka conclave` calls
+- Auto-loaded on subsequent calls
 
 ## The 20 Advisors
 
-| # | Name | DNA | Specialty |
-|---|------|-----|-----------|
-| 1 | Charlie Munger | C+D, 5w6, ISTJ | Inversion, mental models, competence |
-| 2 | Ray Dalio | D+C, 5w6, INTJ | Principles, transparency, systems |
-| 3 | Naval Ravikant | C+D, 5w6, INTP | Leverage, specific knowledge, first principles |
-| 4 | Elon Musk | D+C, 8w7, INTJ | First principles (physics), 10x thinking |
-| 5 | Steve Jobs | D+I, 3w4, ENTJ | Simplicity, taste, A-players |
-| 6 | Simon Sinek | I+S, 2w1, ENFJ | Golden Circle, purpose, infinite game |
-| 7 | Brene Brown | I+S, 4w3, ENFP | Vulnerability, courage, shame resilience |
-| 8 | Peter Drucker | C+S, 1w9, INTJ | Effectiveness, MBO, knowledge workers |
-| 9 | Jeff Bezos | D+C, 3w2, ENTJ | Day 1, working backwards, two-way doors |
-| 10 | Derek Sivers | S+C, 9w1, INFP | Hell Yeah or No, opposites, simplicity |
-| 11 | Nassim Taleb | D+C, 8w7, INTJ | Antifragility, barbell, skin in the game |
-| 12 | Seth Godin | I+C, 7w6, ENFP | Purple Cow, permission, smallest audience |
-| 13 | Patrick Lencioni | I+S, 2w1, ENFJ | Five Dysfunctions, trust, healthy conflict |
-| 14 | Warren Buffett | S+C, 5w6, ISTJ | Circle of competence, margin of safety, moats |
-| 15 | Reed Hastings | D+I, 7w8, ENTJ | Talent density, freedom, context not control |
-| 16 | Marty Cagan | C+I, 1w2, INTJ | Empowered teams, discovery before delivery |
-| 17 | Alex Hormozi | D+C, 8w7, ENTJ | Value equation, Grand Slam Offer, Core Four |
-| 18 | April Dunford | C+I, 5w6, INTP | Positioning, 5 components, Obviously Awesome |
-| 19 | James Clear | S+C, 1w9, INFJ | Atomic Habits, systems over goals, 1% better |
-| 20 | Tim Ferriss | D+I, 7w8, ENTP | Fear-setting, 80/20, minimum effective dose |
+Full table with DNA, specialty, and challenge dimension per advisor: `references/advisors.md`
+
+## Advisor Response Examples
+
+**Charlie Munger (aligned):** "What's the downside? Am I treating the symptom or the disease?"
+
+**Simon Sinek (contrarian):** "What's the WHY? Will people follow because they want to, or because they have to?"
+
+**Ray Dalio (aligned):** "What is the principle here? Is this based on data or opinion?"
+
+**Brene Brown (contrarian):** "Am I being brave enough to be vulnerable here?"

package/arka/skills/conclave/references/advisors.md

@@ -0,0 +1,36 @@
+# The 20 Advisors — arka-conclave
+
+## Aligned Advisors (Think Like You)
+
+| # | Name | Title | DNA | Specialty |
+|---|------|-------|-----|-----------|
+| 1 | Charlie Munger | Vice Chairman, Berkshire Hathaway | C+D, 5w6, ISTJ | Inversion, mental models, circle of competence |
+| 2 | Ray Dalio | Founder, Bridgewater Associates | D+C, 5w6, INTJ | Principles, radical transparency, systems |
+| 3 | Naval Ravikant | AngelList Founder | C+D, 5w6, INTP | Leverage, specific knowledge, first principles |
+| 4 | Elon Musk | CEO Tesla/SpaceX/X | D+C, 8w7, INTJ | First principles (physics), 10x thinking |
+| 5 | Steve Jobs | Apple Co-founder | D+I, 3w4, ENTJ | Simplicity, taste, A-players |
+
+## Contrarian Advisors (Challenge Your Blind Spots)
+
+| # | Name | Title | DNA | Challenge |
+|---|------|-------|-----|-----------|
+| 6 | Simon Sinek | Author, Start With Why | I+S, 2w1, ENFJ | Forces WHY before WHAT/HOW |
+| 7 | Brene Brown | Research Professor | I+S, 4w3, ENFP | Vulnerability over control |
+| 8 | Peter Drucker | Management Consultant | C+S, 1w9, INTJ | Effectiveness, MBO, knowledge workers |
+| 9 | Jeff Bezos | Amazon Founder | D+C, 3w2, ENTJ | Day 1 mindset, working backwards |
+| 10 | Derek Sivers | CD Baby Founder | S+C, 9w1, INFP | Hell Yeah or No, simplicity |
+
+## Extended Advisors
+
+| # | Name | Title | DNA | Specialty |
+|---|------|-------|-----|-----------|
+| 11 | Nassim Taleb | Author, Antifragile | D+C, 8w7, INTJ | Antifragility, barbell, skin in the game |
+| 12 | Seth Godin | Marketing Author | I+C, 7w6, ENFP | Purple Cow, permission, smallest audience |
+| 13 | Patrick Lencioni | Author, Five Dysfunctions | I+S, 2w1, ENFJ | Trust, healthy conflict, team health |
+| 14 | Warren Buffett | Berkshire Hathaway | S+C, 5w6, ISTJ | Circle of competence, moats, margin of safety |
+| 15 | Reed Hastings | Netflix CEO | D+I, 7w8, ENTJ | Talent density, freedom, context not control |
+| 16 | Marty Cagan | Author, Inspired | C+I, 1w2, INTJ | Empowered teams, discovery before delivery |
+| 17 | Alex Hormozi | Acquisition.com Founder | D+C, 8w7, ENTJ | Value equation, Grand Slam Offer, Core Four |
+| 18 | April Dunford | Positioning Expert | C+I, 5w6, INTP | Positioning, 5 components, Obviously Awesome |
+| 19 | James Clear | Author, Atomic Habits | S+C, 1w9, INFJ | Systems over goals, 1% better |
+| 20 | Tim Ferriss | Author, 4-Hour Workweek | D+I, 7w8, ENTP | Fear-setting, 80/20, minimum effective dose |

package/arka/skills/human-writing/SKILL.md

@@ -11,133 +11,48 @@ description: >
 
 # Human Writing Standard — ARKA OS Core Skill
 
-All text produced by ARKA OS must read as if written by a skilled human professional. This is not a guideline; it is a NON-NEGOTIABLE rule enforced by the Constitution.
+All text produced by ARKA OS must read as if written by a skilled human professional. NON-NEGOTIABLE rule — Constitution #8.
 
 ## Scope
 
-This skill applies to **every agent**, **every department**, and **every output type**:
-- Obsidian documents (reports, analyses, specs, ADRs)
-- Terminal responses and summaries
-- Social media posts, captions, stories
-- Email drafts and templates
-- Blog articles and landing page copy
-- Code comments and commit messages
-- PR descriptions and documentation
-- Client-facing deliverables
+Applies to every agent, every department, every output: Obsidian docs, terminal responses, social posts, email drafts, blog articles, landing page copy, code comments, PR descriptions, client deliverables.
 
 ## Rules
 
 ### 1. No Dashes as Sentence Connectors
 
-Never use em-dashes (—), en-dashes (–), or hyphens (-) to join clauses or as sentence connectors. Use commas, semicolons, colons, periods, or conjunctions instead.
+Never use em-dashes (—), en-dashes (–), or hyphens (-) to join clauses. Use commas, semicolons, colons, periods, or conjunctions.
 
-**Allowed exceptions:**
-- Compound adjectives: "well-known", "open-source", "pre-commit"
-- Technical terms: "CI/CD", "key-value", "x-axis"
-- Numeric ranges: "2024-2025", "pages 10-15"
-
-| Bad | Good |
-|-----|------|
-| The system is fast — it handles 10k requests/s | The system is fast. It handles 10k requests per second. |
-| We need three things — speed, reliability, and cost | We need three things: speed, reliability, and cost. |
-| The API failed — the token had expired | The API failed because the token had expired. |
-| Users can choose dark mode — or stay with light | Users can choose dark mode, or stay with light. |
+**Allowed:** Compound adjectives (well-known, open-source), technical terms (CI/CD, key-value), numeric ranges (2024-2025).
 
 ### 2. Language Tone and Idioms
 
-Match the target language's natural register and idiomatic expressions. Never produce translated-sounding text.
-
-**Portuguese:** Use Portuguese idioms, sentence rhythm, and phrasing. Do not translate English constructs literally.
-
-| Bad (translated English) | Good (natural Portuguese) |
-|--------------------------|---------------------------|
-| "Isso é um jogo-mudador" | "Isto muda completamente o panorama" |
-| "No fim do dia" (literal) | "Em última análise" / "Na prática" |
-| "Nós estamos excitados para anunciar" | "Temos o prazer de anunciar" |
-
-**English:** Use natural English rhythm. Avoid overly formal or stiff constructions when the context is conversational.
+Match the target language's natural register. Portuguese: use Portuguese idioms, not translated English constructs. English: natural rhythm, avoid overly formal constructions.
 
 ### 3. Perfect Accentuation and Spelling
 
-Zero tolerance for orthographic errors. Every accent, cedilla, tilde, and diacritic must be correct.
-
-**Portuguese examples:**
-- ação (not acção or acao)
-- é, está, será (accents on stressed syllables)
-- informação, coração, posição (ção endings)
-- três, através, português (circumflex and acute)
-- começar, preço, serviço (cedilla)
-
-**General:** When uncertain about spelling in any language, verify before outputting. An orthographic error in a client deliverable damages credibility.
+Zero tolerance for orthographic errors. Portuguese: ação, é, três, começar. When uncertain, verify before outputting.
 
 ### 4. Varied Sentence Structure
 
-Mix short and long sentences. Avoid starting consecutive sentences with the same word. Use transitions naturally, not as formulaic connectors.
-
-| Bad (repetitive) | Good (varied) |
-|-------------------|---------------|
-| "The API supports pagination. The API also supports filtering. The API returns JSON." | "The API supports pagination and filtering, returning results as JSON." |
-| "We analyzed the data. We found three patterns. We recommend action." | "Our analysis revealed three patterns. Based on these findings, we recommend immediate action." |
+Mix short and long sentences. Avoid starting consecutive sentences with the same word. Use transitions naturally.
 
 ### 5. Forbidden AI Patterns
 
-These phrases and words signal AI-generated text. Never use them:
-
-**Forbidden phrases:**
-- "Let's dive in" / "Let's explore"
-- "Here's a breakdown" / "Here's what you need to know"
-- "In conclusion" / "To summarize"
-- "It's worth noting" / "It's important to note"
-- "At the end of the day"
-- "Moving forward"
-- "That being said"
-- "Without further ado"
-- "Game-changer"
-- "Take it to the next level"
-- "Unlock the potential"
-- "In today's fast-paced world"
-
-**Forbidden words (use alternatives):**
-| Forbidden | Use Instead |
-|-----------|-------------|
-| leverage | use, apply, build on |
-| utilize | use |
-| streamline | simplify, speed up, reduce steps |
-| robust | reliable, solid, thorough |
-| seamless | smooth, effortless, uninterrupted |
-| cutting-edge | modern, current, recent |
-| empower | enable, support, give tools |
-| synergy | collaboration, combined effect |
-| holistic | complete, full, comprehensive |
-| actionable insights | practical recommendations |
+**Forbidden phrases:** "Let's dive in", "Here's a breakdown", "In conclusion", "It's worth noting", "At the end of the day", "Moving forward", "Game-changer", "Unlock the potential", etc.
 
-### 6. Concrete Over Abstract
-
-Prefer specific facts, numbers, and examples over vague qualitative statements.
+**Forbidden words:** leverage → use | utilize → use | streamline → simplify | robust → reliable | seamless → smooth | empower → enable
 
-| Bad (vague) | Good (concrete) |
-|-------------|-----------------|
-| "Significantly improved performance" | "Reduced page load from 3.2s to 0.8s" |
-| "Many users reported issues" | "47 users reported login failures in the last 24 hours" |
-| "The solution is highly scalable" | "The solution handles up to 50k concurrent connections on a single instance" |
+Full list with alternatives: `references/forbidden-patterns.md`
 
-### 7. Active Voice by Default
+### 6. Concrete Over Abstract
 
-Use active voice unless the subject is genuinely unknown or unimportant.
+Specific facts, numbers, examples over vague statements. "Reduced load from 3.2s to 0.8s" beats "significantly improved performance."
 
-| Bad (passive) | Good (active) |
-|---------------|---------------|
-| "The feature was implemented by the team" | "The team implemented the feature" |
-| "Errors are logged by the system" | "The system logs errors" |
-| "The report will be generated" | "The system generates the report" |
+### 7. Active Voice by Default
 
-**Acceptable passive:** "The server was compromised at 03:00 UTC" (attacker unknown).
+Use active voice unless subject is genuinely unknown. "The team implemented the feature" beats "The feature was implemented by the team."
 
 ## Enforcement
 
-This skill is enforced through:
-1. **Constitution L0 injection** — `human-writing` appears in every prompt's NON-NEGOTIABLE list
-2. **Self-critique phase** — Agents review their own output against these rules before delivery
-3. **Cross-department application** — Every department SKILL.md inherits this standard
-
-Agents who produce text that violates these rules must revise before delivering output.
+Constitution L0 injection · Self-critique phase before delivery · Cross-department application. Agents who violate must revise before delivering.

package/arka/skills/human-writing/references/forbidden-patterns.md

@@ -0,0 +1,32 @@
+# Forbidden Writing Patterns — arka-human-writing
+
+## Forbidden Phrases
+
+Never use these AI-signature phrases:
+- "Let's dive in" / "Let's explore"
+- "Here's a breakdown" / "Here's what you need to know"
+- "In conclusion" / "To summarize"
+- "It's worth noting" / "It's important to note"
+- "At the end of the day"
+- "Moving forward"
+- "That being said"
+- "Without further ado"
+- "Game-changer"
+- "Take it to the next level"
+- "Unlock the potential"
+- "In today's fast-paced world"
+
+## Forbidden Words — Use Instead
+
+| Forbidden | Use Instead |
+|-----------|-------------|
+| leverage | use, apply, build on |
+| utilize | use |
+| streamline | simplify, speed up, reduce steps |
+| robust | reliable, solid, thorough |
+| seamless | smooth, effortless, uninterrupted |
+| cutting-edge | modern, current, recent |
+| empower | enable, support, give tools |
+| synergy | collaboration, combined effect |
+| holistic | complete, full, comprehensive |
+| actionable insights | practical recommendations |