arkaos 4.25.0 → 4.27.0

package/README.md

@@ -2,7 +2,7 @@
 
 **The Operating System for AI Agent Teams.**
 
-86 agents. 17 departments. 298 skills. Enterprise frameworks. Multi-runtime. One install.
+89 agents. 17 departments. 329 skills. Enterprise frameworks. Multi-runtime. One install.
 
 ```bash
 npx arkaos install
@@ -95,7 +95,7 @@ npx arkaos doctor    # Health check
 
 ### Skill packs, à la carte
 
-The default install ships a curated core so your context window stays lean. Everything else lives in the ArkaOS plugin marketplace: 16 department packs with 206 skills, generated straight from the same sources the core uses. Inside Claude Code:
+The default install ships a curated core so your context window stays lean. Everything else lives in the ArkaOS plugin marketplace: 16 department packs with 258 skills, generated straight from the same sources the core uses. Inside Claude Code:
 
 ```
 /plugin marketplace add andreagroferreira/arka-os
@@ -158,12 +158,12 @@ Every decision, solution, and pattern is captured. The Cognitive Layer curates i
 |-----------|--------|--------|-------------|
 | **Development** | `/dev` | 15 | Full-stack features, APIs, architecture, security, CI/CD |
 | **Brand & Design** | `/brand` | 10 | Brand identity, UX/UI, design systems, naming |
-| **Marketing** | `/mkt` | 4 | SEO, paid ads, email campaigns, growth loops |
+| **Marketing** | `/mkt` | 7 | SEO, paid ads, lifecycle, PR, positioning, growth loops |
 | **Strategy** | `/strat` | 4 | Market analysis, competitive intelligence, business models |
 | **E-Commerce** | `/ecom` | 4 | Store optimization, CRO, pricing, RFM segmentation |
 | **Knowledge** | `/kb` | 4 | Research, Zettelkasten, persona building, ingestion |
 | **Project Mgmt** | `/pm` | 4 | Scrum, Shape Up, discovery, roadmaps |
-| **Content** | `/content` | 4 | Viral hooks, scripts, repurposing, content calendars |
+| **Content** | `/content` | 8 | Viral hooks, scripts, repurposing, content calendars |
 | **Sales** | `/sales` | 4 | Pipeline management, SPIN selling, negotiation |
 | **SaaS** | `/saas` | 5 | Idea validation, metrics, PLG strategy, scaffolding |
 | **Organization** | `/org` | 5 | Org design, team topologies, matrix structure |
@@ -174,7 +174,7 @@ Every decision, solution, and pattern is captured. The Cognitive Layer curates i
 | **Leadership** | `/lead` | 3 | Team health, OKRs, culture, hiring frameworks |
 | **Quality Gate** | (auto) | 3 | Mandatory review on every workflow. Veto power. |
 
-> 86 agents across 17 departments (85 unique; `cro-specialist` is shared by
+> 89 agents across 17 departments (88 unique; `cro-specialist` is shared by
 > E-Commerce and Landing in the matrix structure).
 
 ---
@@ -532,3 +532,5 @@ See [CONTRIBUTING.md](.github/CONTRIBUTING.md). PRs welcome — all changes requ
 ## License
 
 MIT — [WizardingCode](https://wizardingcode.com)
+
+Third-party material incorporated into ArkaOS is indexed in [docs/THIRD-PARTY-NOTICES.md](docs/THIRD-PARTY-NOTICES.md).

package/THE-ARKAOS-GUIDE.md

@@ -1,6 +1,6 @@
 # The ArkaOS Guide
 
-> v4.25.0 — 86 agents, 17 departments, 298 skills, 270 commands, 16 ADRs.
+> v4.27.0 — 89 agents, 17 departments, 329 skills, 297 commands, 16 ADRs.
 > One file, everything you need to start. Generated by `scripts/guide_gen.py` — never hand-edited.
 
 ## What it is
@@ -39,21 +39,21 @@ answers as a generic assistant.
 |---|---|
 | `/arka` | 22 |
 | `/brand` | 12 |
-| `/community` | 14 |
-| `/content` | 19 |
+| `/community` | 15 |
+| `/content` | 20 |
 | `/dev` | 36 |
 | `/do` | 1 |
 | `/ecom` | 18 |
 | `/fin` | 10 |
 | `/kb` | 22 |
-| `/landing` | 14 |
+| `/landing` | 17 |
 | `/lead` | 10 |
-| `/mkt` | 12 |
+| `/mkt` | 30 |
 | `/ops` | 24 |
 | `/org` | 10 |
 | `/pm` | 12 |
-| `/saas` | 14 |
-| `/sales` | 10 |
+| `/saas` | 15 |
+| `/sales` | 13 |
 | `/strat` | 10 |
 
 ## How work ships

package/VERSION

@@ -1 +1 @@
-4.25.0
+4.27.0

package/arka/SKILL.md

@@ -47,7 +47,7 @@ complementary, not alternatives.
 # ArkaOS — Main Orchestrator
 
 > **The Operating System for AI Agent Teams**
-> 86 agents. 17 departments. 298 skills. Multi-runtime. Dashboard. Knowledge RAG.
+> 89 agents. 17 departments. 329 skills. Multi-runtime. Dashboard. Knowledge RAG.
 
 ## ⛔ Evidence flow — 4 gates (NON-NEGOTIABLE)
 

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

@@ -14,6 +14,10 @@ description: >
   SKIP: code-only diffs with no user-facing prose; the APPROVED/REJECTED
   copy verdict — arka-quality (Quality Gate, Eduardo) wins
   (standard applies WHILE writing, the review judges after).
+metadata:
+  origin: community
+  source: https://github.com/coreyhaines31/marketingskills
+  license: MIT
 ---
 
 # Human Writing Standard — ARKA OS Core Skill
@@ -60,6 +64,70 @@ Specific facts, numbers, examples over vague statements. "Reduced load from 3.2s
 
 Use active voice unless subject is genuinely unknown. "The team implemented the feature" beats "The feature was implemented by the team."
 
+## Self-Editing Before Delivery
+
+The rules above govern how to write. This section governs how to review your
+own prose before it ships, which is where most AI-tells get caught. Run a
+focused pass per dimension instead of one vague read. After each pass,
+recheck the earlier ones so a fix does not reintroduce an old problem.
+
+### The Seven Sweeps
+
+A sequential editing method for high-stakes prose (landing pages, launch
+emails, sales pages). Each sweep looks for one thing:
+
+1. **Clarity:** can the reader understand it? Cut confusing structures, unclear pronouns, insider jargon, and buried points.
+2. **Voice and tone:** does it sound consistent? Catch drift from casual to corporate, mixed references, and accidental mood shifts.
+3. **So what:** does every claim answer "why should I care?" Bridge each feature to a benefit the reader wants.
+4. **Prove it:** is every claim supported? Replace "trusted by thousands" and "industry-leading" with named proof, numbers, and specifics.
+5. **Specificity:** is it concrete? Swap vague verbs for numbers, timeframes, and examples. "Save 4 hours a week" beats "save time."
+6. **Heightened emotion:** does it make the reader feel something? Make the pain and the desired outcome vivid without manipulation.
+7. **Zero risk:** is every barrier to action removed near the CTA? Answer objections, add trust signals, and state the next step plainly.
+
+For a final QA pass, work the full checklist in
+[references/checklist.md](references/checklist.md).
+
+### Quick-Pass Checks
+
+When a full seven-sweep review is not warranted, run these faster checks.
+
+**Cut these words:** very, really, extremely, incredibly (weak intensifiers);
+just, actually, basically (filler); "in order to" (use "to"); "that" when it
+adds nothing; "things" and "stuff" (too vague).
+
+**Watch for:** unnecessary adverbs, passive voice (switch to active per Rule
+7), and nominalizations (turn the noun back into a verb, so "make a decision"
+becomes "decide").
+
+**Sentence level:** one idea per sentence, varied length, important
+information first, no more than three conjunctions, usually under 25 words.
+
+**Paragraph level:** one topic per paragraph, 2 to 4 sentences for web,
+strong opening sentences, and enough white space to stay scannable.
+
+## Plain-English Alternatives
+
+Rule 5 already bans the worst AI words and maps their replacements. Extend it
+with these common offenders:
+
+| Weak or complex | Plain |
+|-----------------|-------|
+| Implement | Set up |
+| Facilitate | Help |
+| Innovative | New |
+| Cutting-edge | New, modern |
+
+The full substitution list lives in
+[references/plain-english-alternatives.md](references/plain-english-alternatives.md).
+
+## Refreshing Existing Content
+
+Prose decays. Stats go stale, examples age, and brand voice drifts across
+edits by different hands. When traffic is declining, data is old, or the
+product has changed, refresh rather than rewrite. The refresh checklist, the
+refresh-versus-rewrite matrix, and a cadence guide are in
+[references/content-refresh.md](references/content-refresh.md).
+
 ## Enforcement
 
 Constitution L0 injection · Self-critique phase before delivery · Cross-department application. Agents who violate must revise before delivering.

package/arka/skills/human-writing/references/checklist.md

@@ -0,0 +1,66 @@
+# Copy Editing Checklist
+
+Use this checklist alongside the Seven Sweeps Framework (see SKILL.md) as a final QA pass before delivering edited copy.
+
+## Before You Start
+
+- [ ] Understand the goal of this copy
+- [ ] Know the target audience
+- [ ] Identify the desired action
+- [ ] Read through once without editing
+
+## Clarity (Sweep 1)
+
+- [ ] Every sentence is immediately understandable
+- [ ] No jargon without explanation
+- [ ] Pronouns have clear references
+- [ ] No sentences trying to do too much
+
+## Voice & Tone (Sweep 2)
+
+- [ ] Consistent formality level throughout
+- [ ] Brand personality maintained
+- [ ] No jarring shifts in mood
+- [ ] Reads well aloud
+
+## So What (Sweep 3)
+
+- [ ] Every feature connects to a benefit
+- [ ] Claims answer "why should I care?"
+- [ ] Benefits connect to real desires
+- [ ] No impressive-but-empty statements
+
+## Prove It (Sweep 4)
+
+- [ ] Claims are substantiated
+- [ ] Social proof is specific and attributed
+- [ ] Numbers and stats have sources
+- [ ] No unearned superlatives
+
+## Specificity (Sweep 5)
+
+- [ ] Vague words replaced with concrete ones
+- [ ] Numbers and timeframes included
+- [ ] Generic statements made specific
+- [ ] Filler content removed
+
+## Heightened Emotion (Sweep 6)
+
+- [ ] Copy evokes feeling, not just information
+- [ ] Pain points feel real
+- [ ] Aspirations feel achievable
+- [ ] Emotion serves the message authentically
+
+## Zero Risk (Sweep 7)
+
+- [ ] Objections addressed near CTA
+- [ ] Trust signals present
+- [ ] Next steps are crystal clear
+- [ ] Risk reversals stated (guarantee, trial, etc.)
+
+## Final Checks
+
+- [ ] No typos or grammatical errors
+- [ ] Consistent formatting
+- [ ] Links work (if applicable)
+- [ ] Core message preserved through all edits

package/arka/skills/human-writing/references/content-refresh.md

@@ -0,0 +1,38 @@
+# Content Refresh Editing
+
+Copy editing isn't just for new content. Existing pages and posts decay over time — outdated stats, stale examples, drifted brand voice, and missed SEO opportunities. A content refresh applies the same editing rigor to content that's already published.
+
+## When to Refresh
+
+- **Traffic declining** on a page that used to perform well
+- **Stats or data** are more than 12 months old
+- **Product has changed** — features, pricing, or positioning no longer match
+- **Competitors updated** their version of the same content
+- **AI search visibility** matters — outdated content gets cited less (see ai-seo skill)
+
+## Content Refresh Checklist
+
+1. **Freshness pass** — Update all dates, stats, and examples. Replace "in 2024" with current data. Remove references to deprecated features or tools.
+2. **Accuracy pass** — Verify all claims are still true. Check that linked resources still exist. Confirm pricing and feature descriptions match current state.
+3. **Voice pass** — Does the tone match your current brand voice? Older content often reflects an earlier stage of the company.
+4. **SEO pass** — Has search intent shifted for this topic? Are there new keywords or questions to address? Add "Last updated: [date]" prominently.
+5. **Proof pass** — Can you add newer testimonials, case studies, or data points that didn't exist when this was first published?
+6. **Structure pass** — Add comparison tables, FAQ sections, or other scannable formats that make the content easier to consume.
+
+## Refresh vs. Rewrite
+
+| Signal | Action |
+|--------|--------|
+| Core message still valid, details outdated | Refresh (update facts, stats, examples) |
+| Brand voice has evolved significantly | Refresh + voice rewrite |
+| Topic angle or audience has shifted | Full rewrite |
+| Page structure doesn't match current search intent | Full rewrite |
+| Just needs updated stats and links | Light refresh |
+
+## Refresh Cadence
+
+- **Pricing and product pages**: Every quarter, or when pricing/features change
+- **High-traffic blog posts**: Every 6 months
+- **Comparison and alternatives pages**: Every 3-6 months (competitors change fast)
+- **Evergreen guides**: Annually, unless traffic drops sooner
+- **Low-traffic pages**: Only when traffic data suggests an opportunity

package/arka/skills/human-writing/references/plain-english-alternatives.md

@@ -0,0 +1,394 @@
+# Plain English Alternatives
+
+Replace complex or pompous words with plain English alternatives.
+
+Source: Plain English Campaign A-Z of Alternative Words (2001), Australian Government Style Manual (2024), plainlanguage.gov
+
+---
+
+## Contents
+- A
+- B
+- C
+- D
+- E
+- F
+- G-H
+- I
+- L-M
+- N-O
+- P
+- R
+- S
+- T-U
+- V-Z
+- Phrases to Remove Entirely
+
+## A
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| (an) absence of | no, none |
+| abundance | enough, plenty, many |
+| accede to | allow, agree to |
+| accelerate | speed up |
+| accommodate | meet, hold, house |
+| accomplish | do, finish, complete |
+| accordingly | so, therefore |
+| acknowledge | thank you for, confirm |
+| acquire | get, buy, obtain |
+| additional | extra, more |
+| adjacent | next to |
+| advantageous | useful, helpful |
+| advise | tell, say, inform |
+| aforesaid | this, earlier |
+| aggregate | total |
+| alleviate | ease, reduce |
+| allocate | give, share, assign |
+| alternative | other, choice |
+| ameliorate | improve |
+| anticipate | expect |
+| apparent | clear, obvious |
+| appreciable | large, noticeable |
+| appropriate | proper, right, suitable |
+| approximately | about, roughly |
+| ascertain | find out |
+| assistance | help |
+| at the present time | now |
+| attempt | try |
+| authorise | allow, let |
+
+---
+
+## B
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| belated | late |
+| beneficial | helpful, useful |
+| bestow | give |
+| by means of | by |
+
+---
+
+## C
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| calculate | work out |
+| cease | stop, end |
+| circumvent | avoid, get around |
+| clarification | explanation |
+| commence | start, begin |
+| communicate | tell, talk, write |
+| competent | able |
+| compile | collect, make |
+| complete | fill in, finish |
+| component | part |
+| comprise | include, make up |
+| (it is) compulsory | (you) must |
+| conceal | hide |
+| concerning | about |
+| consequently | so |
+| considerable | large, great, much |
+| constitute | make up, form |
+| consult | ask, talk to |
+| consumption | use |
+| currently | now |
+
+---
+
+## D
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| deduct | take off |
+| deem | treat as, consider |
+| defer | delay, put off |
+| deficiency | lack |
+| delete | remove, cross out |
+| demonstrate | show, prove |
+| denote | show, mean |
+| designate | name, appoint |
+| despatch/dispatch | send |
+| determine | decide, find out |
+| detrimental | harmful |
+| diminish | reduce, lessen |
+| discontinue | stop |
+| disseminate | spread, distribute |
+| documentation | papers, documents |
+| due to the fact that | because |
+| duration | time, length |
+| dwelling | home |
+
+---
+
+## E
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| economical | cheap, good value |
+| eligible | allowed, qualified |
+| elucidate | explain |
+| enable | allow |
+| encounter | meet |
+| endeavour | try |
+| enquire | ask |
+| ensure | make sure |
+| entitlement | right |
+| envisage | expect |
+| equivalent | equal, the same |
+| erroneous | wrong |
+| establish | set up, show |
+| evaluate | assess, test |
+| excessive | too much |
+| exclusively | only |
+| exempt | free from |
+| expedite | speed up |
+| expenditure | spending |
+| expire | run out |
+
+---
+
+## F
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| fabricate | make |
+| facilitate | help, make possible |
+| finalise | finish, complete |
+| following | after |
+| for the purpose of | to, for |
+| for the reason that | because |
+| forthwith | now, at once |
+| forward | send |
+| frequently | often |
+| furnish | give, provide |
+| furthermore | also, and |
+
+---
+
+## G-H
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| generate | produce, create |
+| henceforth | from now on |
+| hitherto | until now |
+
+---
+
+## I
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| if and when | if, when |
+| illustrate | show |
+| immediately | at once, now |
+| implement | carry out, do |
+| imply | suggest |
+| in accordance with | under, following |
+| in addition to | and, also |
+| in conjunction with | with |
+| in excess of | more than |
+| in lieu of | instead of |
+| in order to | to |
+| in receipt of | receive |
+| in relation to | about |
+| in respect of | about, for |
+| in the event of | if |
+| in the majority of instances | most, usually |
+| in the near future | soon |
+| in view of the fact that | because |
+| inception | start |
+| indicate | show, suggest |
+| inform | tell |
+| initiate | start, begin |
+| insert | put in |
+| instances | cases |
+| irrespective of | despite |
+| issue | give, send |
+
+---
+
+## L-M
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| (a) large number of | many |
+| liaise with | work with, talk to |
+| locality | place, area |
+| locate | find |
+| magnitude | size |
+| (it is) mandatory | (you) must |
+| manner | way |
+| modification | change |
+| moreover | also, and |
+
+---
+
+## N-O
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| negligible | small |
+| nevertheless | but, however |
+| notify | tell |
+| notwithstanding | despite, even if |
+| numerous | many |
+| objective | aim, goal |
+| (it is) obligatory | (you) must |
+| obtain | get |
+| occasioned by | caused by |
+| on behalf of | for |
+| on numerous occasions | often |
+| on receipt of | when you get |
+| on the grounds that | because |
+| operate | work, run |
+| optimum | best |
+| option | choice |
+| otherwise | or |
+| outstanding | unpaid |
+| owing to | because |
+
+---
+
+## P
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| partially | partly |
+| participate | take part |
+| particulars | details |
+| per annum | a year |
+| perform | do |
+| permit | let, allow |
+| personnel | staff, people |
+| peruse | read |
+| possess | have, own |
+| practically | almost |
+| predominant | main |
+| prescribe | set |
+| preserve | keep |
+| previous | earlier, before |
+| principal | main |
+| prior to | before |
+| proceed | go ahead |
+| procure | get |
+| prohibit | ban, stop |
+| promptly | quickly |
+| provide | give |
+| provided that | if |
+| provisions | rules, terms |
+| proximity | nearness |
+| purchase | buy |
+| pursuant to | under |
+
+---
+
+## R
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| reconsider | think again |
+| reduction | cut |
+| referred to as | called |
+| regarding | about |
+| reimburse | repay |
+| reiterate | repeat |
+| relating to | about |
+| remain | stay |
+| remainder | rest |
+| remuneration | pay |
+| render | make, give |
+| represent | stand for |
+| request | ask |
+| require | need |
+| residence | home |
+| retain | keep |
+| revised | changed, new |
+
+---
+
+## S
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| scrutinise | examine, check |
+| select | choose |
+| solely | only |
+| specified | given, stated |
+| state | say |
+| statutory | legal, by law |
+| subject to | depending on |
+| submit | send, give |
+| subsequent to | after |
+| subsequently | later |
+| substantial | large, much |
+| sufficient | enough |
+| supplement | add to |
+| supplementary | extra |
+
+---
+
+## T-U
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| terminate | end, stop |
+| thereafter | then |
+| thereby | by this |
+| thus | so |
+| to date | so far |
+| transfer | move |
+| transmit | send |
+| ultimately | in the end |
+| undertake | agree, do |
+| uniform | same |
+| utilise | use |
+
+---
+
+## V-Z
+
+| Complex | Plain Alternative |
+|---------|-------------------|
+| variation | change |
+| virtually | almost |
+| visualise | imagine, see |
+| ways and means | ways |
+| whatsoever | any |
+| with a view to | to |
+| with effect from | from |
+| with reference to | about |
+| with regard to | about |
+| with respect to | about |
+| zone | area |
+
+---
+
+## Phrases to Remove Entirely
+
+These phrases often add nothing. Delete them:
+
+- a total of
+- absolutely
+- actually
+- all things being equal
+- as a matter of fact
+- at the end of the day
+- at this moment in time
+- basically
+- currently (when "now" or nothing works)
+- I am of the opinion that (use: I think)
+- in due course (use: soon, or say when)
+- in the final analysis
+- it should be understood
+- last but not least
+- obviously
+- of course
+- quite
+- really
+- the fact of the matter is
+- to all intents and purposes
+- very

package/bin/arka

@@ -68,7 +68,7 @@ case "${1:-}" in
     shift
     # Issue #358: the node doctor is canonical (engine/venv/hooks/security
     # + the migrated Claude-layer checks). The bash doctor only audits the
-    # legacy v1 layout — keep it strictly as the no-node fallback.
+    # legacy v1 layout — keep it strictly as the no-npx fallback.
     if command -v npx &>/dev/null; then
       npx arkaos doctor "$@"
       exit $?