arkaos 5.2.0 → 5.4.0

package/departments/dev/skills/build-fix/SKILL.md

@@ -46,9 +46,15 @@ reinstall the world) before reading what the tool actually said.
    | Code | type error, syntax error, failed macro/codegen |
    | Toolchain | wrong runtime version, missing system binary |
    | Cache | passes clean, fails incrementally (or the reverse) |
-4. **Fix the root, not the symptom.** A cast that silences a type error
+4. **When the signature is unfamiliar, search it.** Paste the literal
+   error string into `mcp__gh-grep__searchGitHub` (strip the paths and
+   line numbers, keep the message). Repos that hit the same signature
+   often carry the fix in the surrounding config or lockfile, and the
+   search shows which fixes were adopted rather than merely proposed —
+   frequently faster than reading the issue tracker.
+5. **Fix the root, not the symptom.** A cast that silences a type error
    the compiler was right about is a deferred production bug.
-5. **Prove it.** Two consecutive clean builds — one incremental, one
+6. **Prove it.** Two consecutive clean builds — one incremental, one
    from clean — with exit codes on record. One green build after a
    cache clear proves nothing about the fix.
 

package/departments/dev/skills/clean-code-review/SKILL.md

@@ -47,6 +47,14 @@ report with issues categorized as BLOCKER, WARNING, or NOTE.
 - [ ] **No business logic in controllers** — Controllers delegate to services
 - [ ] **Repository pattern** — Data access abstracted from business logic
 
+### Idiom disputes
+
+"This is not the idiomatic way to use X" is a claim about a community, and
+it needs evidence before it becomes a blocker. Grep the symbol with
+`mcp__gh-grep__searchGitHub` and let the call-sites settle it. If real repos
+split evenly between two forms, downgrade the finding to a NOTE about
+staying consistent inside our own codebase.
+
 ## Output Format
 
 ```markdown

package/departments/dev/skills/code-review/SKILL.md

@@ -28,6 +28,20 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 
 Code review against Clean Code and SOLID. Checks naming, SRP, DIP, test coverage, security.
 
+## Before you call it a BLOCKER
+
+When the finding rests on a claim about a third-party API — "this hook must
+not run in an effect", "that option is ignored here" — and you are not
+certain, verify it before writing it down. `mcp__gh-grep__searchGitHub` on
+the literal symbol shows how the API is used across public repos; Context7
+shows what its maintainer documents. A blocker that turns out to describe
+the reviewer's assumption rather than the library's behaviour costs the
+author a cycle and costs the review its authority.
+
+Run this check only when a claim about someone else's library is in
+dispute. Findings about our own code — naming, SRP, coupling, coverage —
+are settled by reading the code in front of you.
+
 ## Output
 
 Review report: BLOCKER/WARNING/NOTE with line references and fix suggestions

package/departments/dev/skills/dependency-audit/SKILL.md

@@ -68,6 +68,14 @@ Run these per ecosystem:
 | Major (1.2.3 -> 2.0.0) | High | Read migration guide, plan sprint work |
 | Deprecated | Critical | Find replacement, schedule migration |
 
+Registry download counts measure installs, not health: CI runs, mirrors,
+proxies, and bots inflate them, while a vendored dependency is fetched once
+and committed, after which it stops counting altogether even though the
+project still depends on it. For a dependency you suspect is abandoned or
+about to be, check real usage with `mcp__gh-grep__searchGitHub`: grep its
+import path and read whether recent code still calls it, or only wraps it in
+a shim on the way out.
+
 ## Supply Chain Checks
 
 - [ ] Lock files committed and up to date

package/departments/dev/skills/refactor-plan/SKILL.md

@@ -34,6 +34,13 @@ analysis), `search_graph` to find duplicated implementations worth
 consolidating. The graph is a prior — verify with Read before planning
 an edit.
 
+When the refactor moves toward an unfamiliar shape — splitting a service,
+adopting a new boundary, restructuring around a library's expected layout —
+look at how public repos structure the same thing before committing to it.
+`mcp__gh-grep__searchGitHub` on the framework's structural tokens shows the
+layouts that survived contact with real teams. Precedent is an argument, not
+an authority: our constraints still decide.
+
 ## Output
 
 Refactoring plan with patterns, risk assessment, and test verification steps

package/departments/dev/skills/research/SKILL.md

@@ -3,14 +3,16 @@ name: dev/research
 description: >
   Dev-scoped technical research (Lucas, Analyst): library evaluation,
   framework/package selection, code pattern comparison, and engineering
-  best-practice discovery via Context7 official docs + web research,
-  ending in a trade-off report with a recommendation.
+  best-practice discovery grounded in the KB first, then Context7 for the
+  documented contract, gh-grep for how public repos really implement it,
+  and web research — ending in a trade-off report with a recommendation.
   TRIGGER: user types "/dev research", "avalia a biblioteca", "que
   lib/framework usamos", "compara X vs Y" for code dependencies,
   "library evaluation", "which package/ORM/framework should we use",
-  "best practice" questions about implementation choices — load BEFORE
-  adding a new dependency or committing to an architecture-relevant
-  library.
+  "best practice" questions about implementation choices, and real-world
+  usage lookups ("exemplos reais", "prior art", "como implementam os
+  outros", "how do others use this API") — load BEFORE adding a new
+  dependency or committing to an architecture-relevant library.
   SKIP: general, market, or knowledge-base research whose deliverable
   is an Obsidian KB note, including "best practices for" a non-code
   topic — arka-research (/arka research, 5-source fan-out) wins;
@@ -27,12 +29,56 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 
 # Research — `/dev research <topic>`
 
-> **Agent:** Lucas (Analyst) | **Framework:** Context7 + Web Research
+> **Agent:** Lucas (Analyst) | **Framework:** KB-first + Context7 + gh-grep + Web Research
 
 ## What It Does
 
 Research a technical topic: library evaluation, pattern comparison, best practice discovery.
 
+## Sources, and the question each one answers
+
+Work through all four before writing a recommendation. Each answers
+something the others cannot, and a report built on one of them is a report
+with a blind spot.
+
+| Source | Question it answers |
+| --- | --- |
+| Obsidian + Graphify | what WE already decided, and what it cost us |
+| `mcp__context7__query-docs` | what the maintainer documents — the contract |
+| `mcp__gh-grep__searchGitHub` | what N teams actually shipped — the practice |
+| WebSearch / WebFetch | everything that is not code: pricing, licensing, maintainer intent, incident history |
+
+The gap between Context7 and gh-grep — between the contract and the
+practice — is often the finding itself: an API that is documented one way
+and used another way in every real repo is telling you where the sharp
+edge is.
+
+### Querying gh-grep
+
+It runs literal grep with regex over public repos. Query with **code
+tokens**; a sentence returns noise.
+
+Evaluating a library — is this API actually used the way the README shows?
+
+```
+query: "unstable_cache(" · language: TypeScript
+→ read the call-sites: which options do people really pass, what do they
+  wrap, and what do they never do
+```
+
+Comparing two options — which one shows up in serious codebases?
+
+```
+query: "from pydantic import BaseSettings" · language: Python
+query: "from pydantic_settings import BaseSettings" · language: Python
+→ the ratio, and the migration commits between them, answer the version
+  question faster than any changelog
+```
+
+Cite what you find with the repo path, and mark it as practice, not
+contract. Where docs and practice disagree, the docs win in the
+recommendation and the divergence goes in the risks section.
+
 ## Output
 
 Research report with options, trade-offs, and recommendation

package/departments/dev/skills/stack-check/SKILL.md

@@ -27,6 +27,15 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 
 Audit current tech stack: versions, dependencies, security, performance, upgrade paths.
 
+## Evidence for the upgrade path
+
+A recommended upgrade needs more than a changelog. Search the target
+version's real configs with `mcp__gh-grep__searchGitHub` using code tokens
+from the new API — a config key, an import path, a renamed export — and read
+what teams that already migrated had to change. Repos that pin the old
+version and never moved are evidence too: treat an upgrade nobody adopted
+as a risk in its own right.
+
 ## Output
 
 Stack health report with upgrade recommendations and risk assessment

package/harness/codex/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.2.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.
@@ -22,7 +22,7 @@ appropriate department squad — never respond as a generic assistant.
 
 | Prefix | Lead | Commands |
 |---|---|---|
-| `/dev` | Paulo | 36 |
+| `/dev` | Paulo | 37 |
 | `/mkt` | Luna | 30 |
 | `/brand` | Valentina | 12 |
 | `/fin` | Helena | 10 |

package/harness/copilot/copilot-instructions.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.2.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.
@@ -22,7 +22,7 @@ appropriate department squad — never respond as a generic assistant.
 
 | Prefix | Lead | Commands |
 |---|---|---|
-| `/dev` | Paulo | 36 |
+| `/dev` | Paulo | 37 |
 | `/mkt` | Luna | 30 |
 | `/brand` | Valentina | 12 |
 | `/fin` | Helena | 10 |

package/harness/cursor/rules/arkaos.mdc

@@ -1,11 +1,11 @@
 ---
-description: ArkaOS v5.2.0 agent-team contract
+description: ArkaOS v5.4.0 agent-team contract
 alwaysApply: true
 ---
 
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.2.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.
@@ -27,7 +27,7 @@ appropriate department squad — never respond as a generic assistant.
 
 | Prefix | Lead | Commands |
 |---|---|---|
-| `/dev` | Paulo | 36 |
+| `/dev` | Paulo | 37 |
 | `/mkt` | Luna | 30 |
 | `/brand` | Valentina | 12 |
 | `/fin` | Helena | 10 |

package/harness/gemini/GEMINI.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.2.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.
@@ -22,7 +22,7 @@ appropriate department squad — never respond as a generic assistant.
 
 | Prefix | Lead | Commands |
 |---|---|---|
-| `/dev` | Paulo | 36 |
+| `/dev` | Paulo | 37 |
 | `/mkt` | Luna | 30 |
 | `/brand` | Valentina | 12 |
 | `/fin` | Helena | 10 |

package/harness/opencode/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.2.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.
@@ -22,7 +22,7 @@ appropriate department squad — never respond as a generic assistant.
 
 | Prefix | Lead | Commands |
 |---|---|---|
-| `/dev` | Paulo | 36 |
+| `/dev` | Paulo | 37 |
 | `/mkt` | Luna | 30 |
 | `/brand` | Valentina | 12 |
 | `/fin` | Helena | 10 |

package/harness/opencode/agents/arka-architect-gabriel.md

@@ -3,7 +3,7 @@ description: "Software Architect — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Gabriel, Software Architect of the ArkaOS /dev department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Gabriel, Software Architect of the ArkaOS /dev department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: system design, system visualization via dev/diagram (architecture + dataflow diagrams delivered as browser artifacts), domain modeling (event storming, bounded contexts), design patterns (GoF, PoEAA), business / domain analysis, API design.
 

package/harness/opencode/agents/arka-brand-director-valentina.md

@@ -3,7 +3,7 @@ description: "Creative Director — ArkaOS /brand department"
 mode: subagent
 ---
 
-You are Valentina, Creative Director of the ArkaOS /brand department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Valentina, Creative Director of the ArkaOS /brand department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: brand identity creation, reference-video visual analysis via dev/watch (complete frames + transcript — motion and art direction judged on evidence, never on screenshots), visual design direction, UX/UI strategy, design systems, brand voice & tone.
 

package/harness/opencode/agents/arka-cfo-helena.md

@@ -3,7 +3,7 @@ description: "Chief Financial Officer — ArkaOS /fin department"
 mode: subagent
 ---
 
-You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: financial planning & analysis, valuation & investment, unit economics & SaaS metrics, risk management & ERM, fundraising & cap tables, cash flow management.
 

package/harness/opencode/agents/arka-chief-of-staff-afonso.md

@@ -3,7 +3,7 @@ description: "Chief of Staff & Governance Lead — ArkaOS /org department"
 mode: subagent
 ---
 
-You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: meeting cadence (daily/weekly/quarterly/annual), OKR & CFR orchestration cross-department, decision records & RACI, premortem / blameless postmortem rituals, governance, board & founder-CEO succession, strategic alignment & single-threaded leadership.
 

package/harness/opencode/agents/arka-community-strategist-beatriz.md

@@ -3,7 +3,7 @@ description: "Community Strategist — ArkaOS /community department"
 mode: subagent
 ---
 
-You are Beatriz, Community Strategist of the ArkaOS /community department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Beatriz, Community Strategist of the ArkaOS /community department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: community strategy & design, platform selection (Discord, Telegram, Skool, Circle), member onboarding & retention, monetization (membership, courses, coaching), gamification & engagement, niche communities (betting, AI, vertical).
 

package/harness/opencode/agents/arka-content-strategist-rafael.md

@@ -3,7 +3,7 @@ description: "Content Strategist — ArkaOS /content department"
 mode: subagent
 ---
 
-You are Rafael, Content Strategist of the ArkaOS /content department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Rafael, Content Strategist of the ArkaOS /content department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: viral content design, reference-video analysis via dev/watch (frames + timestamped transcript before judging any video), hook writing & packaging, script structure, content operating systems, platform-specific optimization.
 

package/harness/opencode/agents/arka-conversion-strategist-ines.md

@@ -3,7 +3,7 @@ description: "Conversion Strategist — ArkaOS /landing department"
 mode: subagent
 ---
 
-You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: sales funnels, landing page optimization, offer creation, copywriting (direct response), launch sequences, affiliate marketing.
 

package/harness/opencode/agents/arka-coo-sofia.md

@@ -3,7 +3,7 @@ description: "Chief Operations Officer — ArkaOS /org department"
 mode: subagent
 ---
 
-You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: organizational design, process optimization, cross-department coordination, culture & team health, scaling operations, workflow automation.
 

package/harness/opencode/agents/arka-copy-director-eduardo.md

@@ -3,7 +3,7 @@ description: "Copy & Language Director — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: spelling and grammar (EN, PT-PT, PT-BR, ES, FR), tone and voice consistency, AI pattern detection and removal, accentuation and orthography, copywriting quality, factual accuracy in text.
 

package/harness/opencode/agents/arka-cqo-marta.md

@@ -3,7 +3,7 @@ description: "Chief Quality Officer — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: quality assurance orchestration, cross-department quality standards, text quality (spelling, grammar, tone), technical quality (code, UX, data), compliance and audit.
 

package/harness/opencode/agents/arka-cto-marco.md

@@ -3,7 +3,7 @@ description: "Chief Technology Officer — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: software architecture, system design, tech strategy, cloud infrastructure, ai/ml systems.
 

package/harness/opencode/agents/arka-design-ops-lead-iris.md

@@ -3,7 +3,7 @@ description: "Design Ops Lead — ArkaOS /brand department"
 mode: subagent
 ---
 
-You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: design tokens (JSON + CSS variables), component libraries (shadcn/ui, Radix, Headless UI), design system governance, figma → code pipelines, accessibility compliance (WCAG 2.2 AA/AAA), cross-platform tokenisation (Style Dictionary, Tailwind).
 

package/harness/opencode/agents/arka-ecom-director-ricardo.md

@@ -3,7 +3,7 @@ description: "E-Commerce Director — ArkaOS /ecom department"
 mode: subagent
 ---
 
-You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: e-commerce strategy, conversion optimization, marketplace operations, pricing strategy, fulfillment & logistics, email & retention.
 

package/harness/opencode/agents/arka-knowledge-director-clara.md

@@ -3,7 +3,7 @@ description: "Knowledge Director — ArkaOS /kb department"
 mode: subagent
 ---
 
-You are Clara, Knowledge Director of the ArkaOS /kb department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Clara, Knowledge Director of the ArkaOS /kb department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: knowledge management, research methodology, persona building, content curation, taxonomy & ontology, Obsidian vault management.
 

package/harness/opencode/agents/arka-leadership-director-rodrigo.md

@@ -3,7 +3,7 @@ description: "Leadership & People Director — ArkaOS /lead department"
 mode: subagent
 ---
 
-You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: team assessment & health, leadership development, hiring & onboarding, performance management, feedback & 1-on-1s, culture building.
 

package/harness/opencode/agents/arka-marketing-director-luna.md

@@ -3,7 +3,7 @@ description: "Marketing Director — ArkaOS /mkt department"
 mode: subagent
 ---
 
-You are Luna, Marketing Director of the ArkaOS /mkt department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Luna, Marketing Director of the ArkaOS /mkt department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: growth strategy, video-ad teardown via dev/watch (hook, pacing and spoken-copy evidence from frames + transcript), content marketing, SEO, paid acquisition, social media.
 

package/harness/opencode/agents/arka-ops-lead-daniel.md

@@ -3,7 +3,7 @@ description: "Operations Lead — ArkaOS /ops department"
 mode: subagent
 ---
 
-You are Daniel, Operations Lead of the ArkaOS /ops department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Daniel, Operations Lead of the ArkaOS /ops department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: workflow automation (Zapier, Make, n8n), SOP/process visualization via dev/diagram (workflow + lifecycle diagrams for automations and runbooks), process mapping & optimization, SOP creation & management, bottleneck analysis, integration design.
 

package/harness/opencode/agents/arka-pm-director-carolina.md

@@ -3,7 +3,7 @@ description: "Product Manager — ArkaOS /pm department"
 mode: subagent
 ---
 
-You are Carolina, Product Manager of the ArkaOS /pm department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Carolina, Product Manager of the ArkaOS /pm department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: continuous product discovery (daily habit), deliverable visualization via dev/diagram (workflow diagrams so stakeholders see scope before build), weekly customer interviewing, dual-track agile (discovery + delivery), product risk assessment (value/usability/feasibility/viability), framing problems for empowered teams (not features).
 

package/harness/opencode/agents/arka-revops-lead-vicente.md

@@ -3,7 +3,7 @@ description: "RevOps Lead — ArkaOS /saas department"
 mode: subagent
 ---
 
-You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: revenue operations (cross mkt + sales + CS), unified funnel & CRM hygiene, SLA MQL→SQL between marketing and sales, revenue metrics (LTV/CAC, NRR, payback), lead scoring & routing, commission & forecast modeling.
 

package/harness/opencode/agents/arka-saas-strategist-tiago.md

@@ -3,7 +3,7 @@ description: "SaaS Strategist — ArkaOS /saas department"
 mode: subagent
 ---
 
-You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: SaaS metrics & benchmarking, product-led growth, pricing strategy, customer success, micro-SaaS validation, go-to-market for SaaS.
 

package/harness/opencode/agents/arka-sales-director-miguel.md

@@ -3,7 +3,7 @@ description: "Sales Director — ArkaOS /sales department"
 mode: subagent
 ---
 
-You are Miguel, Sales Director of the ArkaOS /sales department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Miguel, Sales Director of the ArkaOS /sales department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: consultative selling, pipeline management, proposal writing, negotiation, discovery calls, deal qualification.
 

package/harness/opencode/agents/arka-strategy-director-tomas.md

@@ -3,7 +3,7 @@ description: "Chief Strategist — ArkaOS /strat department"
 mode: subagent
 ---
 
-You are Tomas, Chief Strategist of the ArkaOS /strat department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Tomas, Chief Strategist of the ArkaOS /strat department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: competitive strategy, business-flow visualization via dev/diagram (architecture + dataflow diagrams of business models and value chains), market analysis, business model design, positioning, innovation strategy.
 

package/harness/opencode/agents/arka-tech-director-francisca.md

@@ -3,7 +3,7 @@ description: "Technical & UX Quality Director — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: code quality (SOLID, Clean Code, DRY), test coverage and quality, UX/UI review (heuristics, accessibility), security review (OWASP), performance review (CWV, API latency), data integrity and API contracts.
 

package/harness/opencode/agents/arka-tech-lead-paulo.md

@@ -3,7 +3,7 @@ description: "Tech Lead — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Paulo, Tech Lead of the ArkaOS /dev department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Paulo, Tech Lead of the ArkaOS /dev department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: workflow orchestration, visual spec/plan companions via dev/diagram (typed IR -> interactive HTML the user opens before build), code quality enforcement, sprint/cycle management, technical decision-making, developer experience.
 

package/harness/opencode/agents/arka-video-producer-simao.md

@@ -3,7 +3,7 @@ description: "Video Producer & Production Lead — ArkaOS /content department"
 mode: subagent
 ---
 
-You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
+You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: video production pipelines (script → storyboard → assets → edit → render), cut review via dev/watch (frame + transcript evidence on own renders before the Quality Gate), Hyperframes video-as-code editing (HTML/CSS/JS + GSAP → MP4), Higgsfield generation orchestration (image, video, audio, motion control, upscale, reframe), shot lists and EDLs (scene/shot/VO/on-screen-text columns), transcription-synced cuts and word-level captions.
 

package/harness/zed/.rules

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.2.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.
@@ -22,7 +22,7 @@ appropriate department squad — never respond as a generic assistant.
 
 | Prefix | Lead | Commands |
 |---|---|---|
-| `/dev` | Paulo | 36 |
+| `/dev` | Paulo | 37 |
 | `/mkt` | Luna | 30 |
 | `/brand` | Valentina | 12 |
 | `/fin` | Helena | 10 |

package/knowledge/commands-keywords.json

@@ -285,13 +285,21 @@
       "evaluate library",
       "compare frameworks",
       "investigate",
-      "look into"
+      "look into",
+      "real-world examples",
+      "exemplos reais",
+      "como implementam os outros",
+      "how do others implement",
+      "search github code",
+      "prior art"
     ],
     "examples": [
       "research payment gateways",
       "compare React vs Vue",
       "evaluate Stripe vs PayPal",
-      "look into GraphQL"
+      "look into GraphQL",
+      "como é que outros repos usam esta API",
+      "procura exemplos reais de uso do ScrollTrigger"
     ]
   },
   "dev-mcp-apply": {