arkaos 4.27.0 → 4.28.0

package/THE-ARKAOS-GUIDE.md

@@ -1,6 +1,6 @@
 # The ArkaOS Guide
 
-> v4.27.0 — 89 agents, 17 departments, 329 skills, 297 commands, 16 ADRs.
+> v4.28.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

package/VERSION

@@ -1 +1 @@
-4.27.0
+4.28.0

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

@@ -40,6 +40,8 @@ Never use em-dashes (—), en-dashes (–), or hyphens (-) to join clauses. Use
 
 Match the target language's natural register. Portuguese: use Portuguese idioms, not translated English constructs. English: natural rhythm, avoid overly formal constructions.
 
+Portuguese output has its own AI-tell catalogue: `references/pt-pt-anti-slop.md`.
+
 ### 3. Perfect Accentuation and Spelling
 
 Zero tolerance for orthographic errors. Portuguese: ação, é, três, começar. When uncertain, verify before outputting.
@@ -64,6 +66,18 @@ 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."
 
+### 8. No Formulaic Structures
+
+Structural patterns are stronger AI tells than any single word: they
+survive synonym swaps. Banned: binary contrasts ("not X, it's Y"),
+negative listing, dramatic fragmentation, rhetorical setups ("What if I
+told you..."), false agency (inanimate nouns doing human verbs: "the data
+tells us", "the decision emerges"; name the human), narrator-from-a-distance,
+Wh-word sentence openers, and lazy extremes (every/always/never doing
+vague work). Full catalogue with fixes: `references/structural-patterns.md`.
+Phrase-level companions (throat-clearing openers, emphasis crutches,
+meta-commentary, vague declaratives): `references/anti-slop-phrases.md`.
+
 ## Self-Editing Before Delivery
 
 The rules above govern how to write. This section governs how to review your
@@ -95,16 +109,40 @@ When a full seven-sweep review is not warranted, run these faster checks.
 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"
+**Watch for:** adverbs (cut by default; one survives only if deleting it
+changes the meaning), passive voice (switch to active per Rule 7), and
+nominalizations (turn the noun back into a verb, so "make a decision"
 becomes "decide").
 
+**Structural sweep (Rule 8):** no Wh-word sentence openers; no "not X,
+it's Y" contrasts; name the human behind inanimate verbs (false agency);
+cut throat-clearing openers ("Here's the thing:", "It turns out"); rewrite
+anything that sounds like a pull-quote; default to two list items, a third
+must earn its place; vary paragraph endings instead of closing every one
+punchily.
+
 **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.
 
+### Slop Score
+
+A fast quantitative gate, complement to the Seven Sweeps. Rate the draft
+1 to 10 on each dimension; below 35/50, revise before delivering.
+
+| Dimension | Question |
+|-----------|----------|
+| Directness | Statements or announcements? |
+| Rhythm | Varied or metronomic? |
+| Trust | Respects reader intelligence? |
+| Authenticity | Sounds human? |
+| Density | Anything cuttable? |
+
+Eduardo (Quality Gate) applies the same rubric to changed copy: below
+35/50 on COPY-scope prose is a blocker.
+
 ## Plain-English Alternatives
 
 Rule 5 already bans the worst AI words and maps their replacements. Extend it

package/arka/skills/human-writing/references/anti-slop-phrases.md

@@ -0,0 +1,131 @@
+<!-- Derived from stop-slop by Hardik Pandya — https://github.com/hardikpandya/stop-slop -->
+<!-- MIT — Copyright (c) 2025 Hardik Pandya. See docs/THIRD-PARTY-NOTICES.md. -->
+
+# Anti-Slop Phrases — arka-human-writing
+
+Complements `forbidden-patterns.md` (Rule 5) and the constitution
+`no-ai-cliches` list. Entries already banned there are not repeated here.
+
+## Throat-Clearing Openers
+
+Remove these announcement phrases. State the content directly.
+
+- "Here's the thing:"
+- "Here's what [X]"
+- "Here's this [X]"
+- "Here's that [X]"
+- "Here's why [X]"
+- "The uncomfortable truth is"
+- "It turns out"
+- "The real [X] is"
+- "Let me be clear"
+- "The truth is,"
+- "I'll say it again:"
+- "I'm going to be honest"
+- "Can we talk about"
+- "Here's what I find interesting"
+- "Here's the problem though"
+
+Any "here's what/this/that" construction is throat-clearing before the point. Cut it and state the point.
+
+## Emphasis Crutches
+
+These add no meaning. Delete them.
+
+- "Full stop." / "Period."
+- "Let that sink in."
+- "This matters because"
+- "Make no mistake"
+- "Here's why that matters"
+
+## Business Jargon
+
+Replace with plain language. ("Navigate", "deep dive", "cutting-edge",
+"game-changer" and "moving forward" are already banned by the constitution
+list and Rule 5.)
+
+| Avoid | Use instead |
+|-------|-------------|
+| Unpack (analysis) | Explain, examine |
+| Lean into | Accept, embrace |
+| Landscape (context) | Situation, field |
+| Double down | Commit, increase |
+| Take a step back | Reconsider |
+| Circle back | Return to, revisit |
+| On the same page | Aligned, agreed |
+
+## Adverbs
+
+Cut adverbs by default; one survives only if deleting it changes the
+meaning. No softeners, no intensifiers, no hedges.
+
+Specific offenders:
+
+- "really"
+- "just"
+- "literally"
+- "genuinely"
+- "honestly"
+- "simply"
+- "actually"
+- "deeply"
+- "truly"
+- "fundamentally"
+- "inherently"
+- "inevitably"
+- "interestingly"
+- "importantly"
+- "crucially"
+
+Also cut these filler phrases:
+
+- "At its core"
+- "In today's [X]"
+- "When it comes to"
+- "In a world where"
+- "The reality is"
+
+## Meta-Commentary
+
+Remove self-referential asides. The text should move, not announce its own structure.
+
+- "Hint:"
+- "Plot twist:" / "Spoiler:"
+- "You already know this, but"
+- "But that's another post"
+- "X is a feature, not a bug"
+- "Dressed up as"
+- "The rest of this essay explains..."
+- "Let me walk you through..."
+- "In this section, we'll..."
+- "As we'll see..."
+- "I want to explore..."
+
+## Performative Emphasis
+
+False intimacy or manufactured sincerity:
+
+- "creeps in"
+- "I promise"
+- "They exist, I promise"
+
+## Telling Instead of Showing
+
+Announcing difficulty or significance rather than demonstrating it:
+
+- "This is genuinely hard"
+- "This is what leadership actually looks like"
+- "This is what X actually looks like"
+- "actually matters"
+
+## Vague Declaratives
+
+Sentences that announce importance without naming the specific thing. Kill these.
+
+- "The reasons are structural"
+- "The implications are significant"
+- "This is the deepest problem"
+- "The stakes are high"
+- "The consequences are real"
+
+If a sentence says something is important/deep/structural without showing the specific thing, cut it or replace it with the specific thing.

package/arka/skills/human-writing/references/pt-pt-anti-slop.md

@@ -0,0 +1,82 @@
+# Anti-Slop em Português Europeu — arka-human-writing
+
+Equivalentes pt-PT dos padrões de IA catalogados em
+`structural-patterns.md` e `anti-slop-phrases.md` (esses ficheiros são
+EN-only). Autoria ArkaOS. Aplica-se a todo o output em português; pt-PT,
+nunca pt-BR (Rule 3 da skill).
+
+## Aberturas de limpar a garganta
+
+Anunciar o conteúdo em vez de o dizer. Cortar e afirmar diretamente.
+
+- "Vamos mergulhar em..."
+- "É importante notar que..."
+- "Neste artigo vamos ver..."
+- "A verdade é que..."
+- "Sejamos honestos:"
+- "Aqui está o que precisas de saber"
+- "O que é facto é que..."
+
+## Contraste binário
+
+Drama fabricado por negação seguida de afirmação. Afirmar Y e cortar a negação.
+
+- "Não é X, é Y." / "Não se trata de X, trata-se de Y."
+- "A questão não é X. É Y."
+- "O problema não é X. O problema é Y."
+- "Não é só X, é também Y."
+
+## Falsa agência
+
+Verbos humanos em sujeitos inanimados escondem quem age. Nomear a pessoa;
+sem pessoa concreta, usar "tu"/"você" e pôr o leitor na cena.
+
+- "a decisão nasce" → alguém decide
+- "o projeto ganha vida" → a equipa lança o projeto
+- "os dados dizem-nos" → alguém lê os dados e conclui
+- "o mercado premeia" → os clientes pagam por
+- "a cultura muda" → as pessoas mudam de comportamento
+
+## Advérbios em -mente empilhados
+
+Cortar por defeito; um advérbio sobrevive só se apagá-lo mudar o
+significado. Ofensores frequentes: "basicamente", "literalmente",
+"genuinamente", "honestamente", "simplesmente", "efetivamente",
+"fundamentalmente", "inevitavelmente", "verdadeiramente".
+
+## Travessão como conector
+
+"O produto — que mudou o mercado — cresceu" é o tell número um. A Rule 1
+da skill já proíbe travessões e hífenes como conectores de orações em
+qualquer língua: usar vírgulas, dois pontos, ponto final ou conjunções.
+
+## Extremos preguiçosos
+
+Autoridade falsa por generalização: "sempre", "nunca", "todos",
+"ninguém", "qualquer pessoa". Substituir pela afirmação específica que se
+consegue provar.
+
+## Declarativas vagas
+
+Anunciam importância sem nomear a coisa. Cortar ou substituir pelo
+específico.
+
+- "As implicações são profundas."
+- "O impacto é real."
+- "Os desafios são estruturais."
+- "Está tudo em jogo."
+
+## Jargão traduzido do inglês
+
+Construções decalcadas do inglês empresarial que nenhum falante nativo
+usa espontaneamente.
+
+| Evitar | Usar |
+|--------|------|
+| alavancar (resultados) | usar, tirar partido de |
+| robusto (solução) | sólido, fiável |
+| impulsionar (crescimento) | acelerar, fazer crescer |
+| desbloquear o potencial | aproveitar |
+| endereçar (um problema) | resolver, tratar de |
+| navegar (a incerteza) | lidar com, gerir |
+| num mundo em constante mudança | (cortar; dizer o específico) |

package/arka/skills/human-writing/references/stop-slop.LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hardik Pandya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -0,0 +1,151 @@
+<!-- Derived from stop-slop by Hardik Pandya — https://github.com/hardikpandya/stop-slop -->
+<!-- MIT — Copyright (c) 2025 Hardik Pandya. See docs/THIRD-PARTY-NOTICES.md. -->
+
+# Structural Patterns to Avoid — arka-human-writing
+
+Formulaic sentence and paragraph structures are stronger AI tells than any
+single banned word: they survive synonym swaps. Rule 8 of the skill bans
+them; this file is the catalogue.
+
+## Binary Contrasts
+
+These create false drama. State the point directly.
+
+| Pattern | Problem |
+|---------|---------|
+| "Not because X. Because Y." / "Not because X, but because Y." | Telegraphed reversal |
+| "[X] isn't the problem. [Y] is." | Formulaic reframe |
+| "The answer isn't X. It's Y." | Predictable pivot |
+| "It feels like X. It's actually Y." | Setup/reveal cliche |
+| "The question isn't X. It's Y." | Rhetorical misdirection |
+| "Not X. But Y." / "not X, it's Y" / "isn't X, it's Y" | Mechanical contrast |
+| "It's not this. It's that." | Same formula, different words |
+| "stops being X and starts being Y" | False transformation arc |
+| "doesn't mean X, but actually Y" | Negation-then-assertion crutch |
+| "is about X but not Y" | False distinction |
+| "not just X but also Y" | Additive hedge |
+
+**Instead:** State Y directly. "The problem is Y." "Y matters here." Drop the negation entirely.
+
+## Negative Listing
+
+Listing what something is *not* before revealing what it *is*. A rhetorical striptease.
+
+| Pattern | Problem |
+|---------|---------|
+| "Not a X... Not a Y... A Z." | Dramatic buildup through negation |
+| "It wasn't X. It wasn't Y. It was Z." | Same structure, past tense |
+
+**Instead:** State Z. The reader doesn't need the runway.
+
+## Dramatic Fragmentation
+
+Sentence fragments for emphasis read as manufactured profundity.
+
+| Pattern | Problem |
+|---------|---------|
+| "[Noun]. That's it. That's the [thing]." | Performative simplicity |
+| "X. And Y. And Z." | Staccato drama |
+| "This unlocks something. [Word]." | Artificial revelation |
+
+**Instead:** Complete sentences. Trust content over presentation.
+
+## Rhetorical Setups
+
+These announce insight rather than deliver it.
+
+| Pattern | Problem |
+|---------|---------|
+| "What if [reframe]?" | Socratic posturing |
+| "Here's what I mean:" | Redundant preview |
+| "Think about it:" | Condescending prompt |
+| "And that's okay." | Unnecessary permission |
+
+**Instead:** Make the point. Let readers draw conclusions.
+
+## Formulaic Constructions
+
+| Pattern | Problem |
+|---------|---------|
+| "By the time X, I was Y." | Narrative template |
+| "X that isn't Y" | Indirect. Say "X is broken" |
+
+## False Agency
+
+Giving inanimate things human verbs. Complaints don't "become" fixes. Bets
+don't "live or die." Decisions don't "emerge." A person does something to
+make those things happen. AI loves this because it avoids naming the actor.
+
+| Pattern | Problem |
+|---------|---------|
+| "a complaint becomes a fix" | The complaint did nothing. Someone fixed it. |
+| "a bet lives or dies in days" | Bets don't have lifespans. Someone kills the project or ships it. |
+| "the decision emerges" | Decisions don't emerge. Someone decides. |
+| "the culture shifts" | Cultures don't shift on their own. People change behavior. |
+| "the conversation moves toward" | Conversations don't move. Someone steers. |
+| "the data tells us" | Data sits there. Someone reads it and draws a conclusion. |
+| "the market rewards" | Markets don't reward. Buyers pay for things. |
+
+**Instead:** Name the human. "The team fixed it that week" beats "the complaint becomes a fix." If no specific person fits, use "you" to put the reader in the seat.
+
+## Narrator-from-a-Distance
+
+Floating above the scene instead of putting the reader in it.
+
+| Pattern | Problem |
+|---------|---------|
+| "Nobody designed this." | Disembodied observation |
+| "This happens because..." | Lecturer voice |
+| "This is why..." | Same |
+| "People tend to..." | Armchair sociologist |
+
+**Instead:** Put the reader in the room. "You don't sit down one day and decide to..." beats "Nobody designed this."
+
+## Passive Voice
+
+Rule 7 of the skill (Active Voice by Default) governs this. The recurring
+offenders, kept here because they pair with False Agency: "X was created",
+"It is believed that", "Mistakes were made", "The decision was reached".
+Find the actor and put them at the front of the sentence.
+
+## Sentence Starters to Avoid
+
+| Pattern | Fix |
+|---------|-----|
+| Sentences starting with What, When, Where, Which, Who, Why, How | Restructure. Lead with the subject or the verb. |
+| Paragraphs starting with "So" | Start with content |
+| Sentences starting with "Look," | Remove |
+
+Wh- openers become a crutch. "What makes this hard is..." becomes "The constraint is..." or better, name the specific constraint.
+
+## Rhythm Patterns
+
+| Pattern | Fix |
+|---------|-----|
+| Three-item lists by reflex | Default to two items or one; a third must earn its place. Deliberate triads in copywriting frameworks stay legitimate. |
+| Questions answered immediately | Let questions breathe or cut them |
+| Every paragraph ends punchily | Vary endings |
+| Dashes as connectors | Already banned by Rule 1 of the skill; no em-dashes at all |
+| Staccato fragmentation | Don't stack short punchy sentences |
+| "Not always. Not perfectly." | Hedging disguised as reassurance |
+
+## Word Patterns
+
+| Pattern | Problem |
+|---------|---------|
+| Lazy extremes (every, always, never, everyone, everybody, nobody) | False authority. Use specifics instead of sweeping claims. |
+| Adverb pile-up | Empty emphasis. Cut adverbs by default; one survives only if deleting it changes the meaning. Full list: `anti-slop-phrases.md`. |
+
+## Before/After
+
+**Throat-clearing + binary contrast:**
+> Before: "Here's the thing: building products is hard. Not because the technology is complex. Because people are complex. Let that sink in."
+> After: "Building products is hard. Technology is manageable. People aren't."
+
+**Dramatic fragmentation:**
+> Before: "Speed. Quality. Cost. You can only pick two. That's it. That's the tradeoff."
+> After: "Speed, quality, cost: pick two."
+
+**Rhetorical setup:**
+> Before: "What if I told you that the best teams don't optimize for productivity? Here's what I mean: they optimize for learning. Think about it."
+> After: "The best teams optimize for learning, not productivity."

package/config/claude-agents/content-marketer.md

@@ -47,4 +47,4 @@ You are Mariana, Content Marketing Specialist of the marketing squad (Tier 2). W
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: Content Pillar-Cluster, STEPPS (Berger), Schwartz 5 Awareness Levels, Content Operating System, Editorial Calendar. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, Content Pillar-Cluster, STEPPS (Berger), Schwartz 5 Awareness Levels, Content Operating System, Editorial Calendar. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/content-strategist.md

@@ -47,4 +47,4 @@ You are Rafael, Content Strategist of the content squad (Tier 1). What drives yo
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: STEPPS (Berger), Hook Architecture, Content OS (GaryVee model), Platform Algorithms (YouTube/TikTok/IG/LinkedIn), Content-to-Revenue Pipeline, AI Content Workflow. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, STEPPS (Berger), Hook Architecture, Content OS (GaryVee model), Platform Algorithms (YouTube/TikTok/IG/LinkedIn), Content-to-Revenue Pipeline, AI Content Workflow. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/eduardo-copy.md

@@ -33,12 +33,25 @@ the changed files. Your duties:
      "robust", "comprehensive", "streamline", "unlock", "tapestry",
      "dive deep", "navigate", "realm of", "cutting-edge",
      "in today's fast-paced", "underscore"
+   - structural-slop sweep (catalogue:
+     `arka/skills/human-writing/references/structural-patterns.md`): flag
+     binary contrasts ("not X, it's Y"), negative listing, dramatic
+     fragmentation, rhetorical setups, false agency (inanimate nouns with
+     human verbs), narrator-from-a-distance, Wh-word sentence openers,
+     throat-clearing openers, vague declaratives, metronomic rhythm
 3. Evidence floor: if the report `overall` is "fail", your verdict is
    REJECTED even if the copy is perfect — you never approve over failing
    evidence.
 
 ## Verdict Format
 
+Score the changed prose with the Slop Score rubric
+(`arka/skills/human-writing/SKILL.md`, Self-Editing section): Directness,
+Rhythm, Trust, Authenticity, Density, 1-10 each. Report "slop-score: X/50"
+in `notes`. Below 35/50 on COPY-scope changed prose (landing pages,
+campaigns, posts, client deliverables) it is a blocker; on
+DOCUMENTATION-scope prose it is advisory.
+
 Return a `QGVerdict` JSON object (schema: `QG_VERDICT_JSON_SCHEMA` in
 `core.governance.qg_verdict`): `verdict`, `evidence_report` summary,
 `blockers` [{check, detail, file, verdict}] with exact location and

package/config/claude-agents/lifecycle-marketer.md

@@ -47,4 +47,4 @@ You are Raquel, Lifecycle & Retention Marketer of the marketing squad (Tier 2).
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: AARRR, RFM, Hooked, Welcome/Nurture/Win-back flow patterns, Sender reputation management. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, AARRR, RFM, Hooked, Welcome/Nurture/Win-back flow patterns, Sender reputation management. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/product-marketer.md

@@ -47,4 +47,4 @@ You are Lourenço, Product Marketing Manager of the marketing squad (Tier 2). Wh
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: Obviously Awesome, JTBD Four Forces, Schwartz 5 Levels, Crossing the Chasm, Win/Loss Analysis, April Dunford 10-step positioning. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, Obviously Awesome, JTBD Four Forces, Schwartz 5 Levels, Crossing the Chasm, Win/Loss Analysis, April Dunford 10-step positioning. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/repurpose-distributor.md

@@ -47,4 +47,4 @@ You are Nuno, Repurpose & Distribution Specialist of the content squad (Tier 2).
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: GaryVee Pillar→30+ Model, Justin Welsh Content OS, Platform Algorithm Signals, Content-to-Revenue Pipeline. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, GaryVee Pillar→30+ Model, Justin Welsh Content OS, Platform Algorithm Signals, Content-to-Revenue Pipeline. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/sales-copywriter.md

@@ -48,4 +48,4 @@ You are Teresa, Sales Copywriter of the landing squad (Tier 2). What drives you:
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: AIDA, PAS (Problem-Agitate-Solve), PASTOR, StoryBrand SB7, Schwartz 5 Awareness Levels, Star-Story-Solution, Halbert Headline Formulas. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, AIDA, PAS (Problem-Agitate-Solve), PASTOR, StoryBrand SB7, Schwartz 5 Awareness Levels, Star-Story-Solution, Halbert Headline Formulas. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/scriptwriter.md

@@ -49,4 +49,4 @@ You are Joana, Scriptwriter of the content squad (Tier 2). What drives you: Craf
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: Story (McKee), Save the Cat beat sheet, Dan Harmon Story Circle, Sequence method, Pixar story rules, Hook Architecture, Hook-Bridge-Body-CTA, StoryBrand SB7 (adapted for video), AIDA for video, MrBeast Retention Techniques. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, Story (McKee), Save the Cat beat sheet, Dan Harmon Story Circle, Sequence method, Pixar story rules, Hook Architecture, Hook-Bridge-Body-CTA, StoryBrand SB7 (adapted for video), AIDA for video, MrBeast Retention Techniques. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/viral-engineer.md

@@ -47,4 +47,4 @@ You are Filipe, Viral Content Engineer of the content squad (Tier 2). What drive
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: STEPPS (Berger), Hook Architecture (3-second rule), MrBeast Title/Thumb Method, Platform-Specific Signals. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep, STEPPS (Berger), Hook Architecture (3-second rule), MrBeast Title/Thumb Method, Platform-Specific Signals. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/evals/marketing.yaml

@@ -1731,6 +1731,80 @@
   tags:
   - human-writing
   - imported
+- id: marketing-human-writing-07
+  department: marketing
+  prompt: 'Rewrite this launch-post paragraph: ''Here''s the thing: shipping fast isn''t
+    the problem. Shipping the wrong thing is. What if I told you the answer isn''t more
+    process? When the feedback loop tightens, the product improves. The implications are
+    significant. Not a framework. Not a methodology. A habit.'''
+  expected_properties:
+  - Identifies throat-clearing opener ("Here's the thing:")
+  - Identifies binary contrasts ("isn't the problem... is", "the answer isn't")
+  - Identifies rhetorical setup ("What if I told you")
+  - Identifies false agency ("the feedback loop tightens, the product improves")
+  - Identifies vague declarative ("The implications are significant")
+  - Identifies negative listing ("Not a framework. Not a methodology. A habit.")
+  - Rewrite states points directly and names the human actor
+  rubric: 'Should apply Rule 8 (No Formulaic Structures) and the structural-patterns
+    catalogue. Should flag every structural pattern in the paragraph: throat-clearing
+    opener, two binary contrasts, rhetorical setup, false agency (nobody tightens the
+    loop or improves the product in the sentence — the rewrite must name who does),
+    vague declarative, and negative listing. The rewrite should state each point as a
+    direct claim with a human subject, without introducing new AI patterns (no em
+    dashes, no fresh contrasts). Should not merely reword phrases while keeping the
+    structures.'
+  tags:
+  - human-writing
+- id: marketing-human-writing-08
+  department: marketing
+  prompt: 'Limpa este parágrafo de um email de lançamento: ''Vamos mergulhar no que
+    torna este produto verdadeiramente único. Não se trata de mais uma ferramenta,
+    trata-se de uma nova forma de trabalhar. Basicamente, a plataforma ganha vida
+    com os teus dados — e os resultados falam por si. As implicações são profundas.'''
+  expected_properties:
+  - Responds in European Portuguese (pt-PT)
+  - Identifies "Vamos mergulhar" as throat-clearing
+  - Identifies "Não se trata de X, trata-se de Y" as binary contrast
+  - Identifies stacked -mente adverbs ("verdadeiramente", "basicamente")
+  - Identifies false agency ("a plataforma ganha vida", "os resultados falam")
+  - Identifies em dash used as connector
+  - Identifies vague declarative ("As implicações são profundas")
+  - Rewrite is idiomatic pt-PT with named actors and direct claims
+  rubric: 'Should apply references/pt-pt-anti-slop.md and respond in pt-PT (never
+    pt-BR). Should flag: "Vamos mergulhar" (abertura de limpar a garganta),
+    "Não se trata de... trata-se de" (contraste binário), "verdadeiramente" and
+    "basicamente" (advérbios a cortar por defeito), "a plataforma ganha vida" and
+    "os resultados falam por si" (falsa agência — nomear quem faz), the em dash
+    connector (Rule 1), and "As implicações são profundas" (declarativa vaga).
+    The rewrite must be natural European Portuguese with direct statements and
+    human subjects, and must not translate English constructs literally.'
+  tags:
+  - human-writing
+- id: marketing-human-writing-09
+  department: marketing
+  prompt: 'Score this draft with the Slop Score rubric and tell me if it ships:
+    ''In today''s fast-paced landscape, teams need to navigate complexity. Here''s
+    why that matters: productivity isn''t about tools. It''s about focus. Really,
+    the data tells us everything. Make no mistake, this changes everything. The
+    stakes are high.'''
+  expected_properties:
+  - Applies the five Slop Score dimensions (Directness, Rhythm, Trust, Authenticity, Density)
+  - Scores each dimension 1-10 with a one-line justification
+  - Total is clearly below the 35/50 threshold
+  - Verdict is revise, not ship
+  - Names the specific offending patterns per dimension
+  - Offers a revised version or the concrete revision steps
+  rubric: 'Should apply the Slop Score rubric from the human-writing skill: rate
+    Directness, Rhythm, Trust, Authenticity, and Density 1-10 each with brief
+    justification tied to specific text (cliches "in today''s fast-paced" and
+    "navigate", emphasis crutches "Here''s why that matters" and "Make no
+    mistake", binary contrast "isn''t about tools. It''s about focus", false
+    agency "the data tells us", vague declarative "The stakes are high",
+    metronomic short sentences). The total must land clearly below 35/50 and the
+    verdict must be revise-before-shipping, with a rewrite or concrete steps.
+    Should not score generously to avoid the revision.'
+  tags:
+  - human-writing
 - id: marketing-customer-research-01
   department: marketing
   prompt: I have 20 customer interview transcripts. Help me analyze them.

package/departments/content/agents/content-strategist.yaml

@@ -56,6 +56,7 @@ expertise:
     - AI-augmented content creation
     - creator monetization
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - STEPPS (Berger)
     - Hook Architecture
     - Content OS (GaryVee model)

package/departments/content/agents/repurpose-distributor.yaml

@@ -41,6 +41,7 @@ expertise:
     - AI-assisted content workflows
     - analytics & performance tracking
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - GaryVee Pillar→30+ Model
     - Justin Welsh Content OS
     - Platform Algorithm Signals

package/departments/content/agents/scriptwriter.yaml

@@ -51,6 +51,7 @@ expertise:
     - podcast scripts
     - webinar scripts
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - Story (McKee)
     - Save the Cat beat sheet
     - Dan Harmon Story Circle

package/departments/content/agents/viral-engineer.yaml

@@ -40,6 +40,7 @@ expertise:
     - trend analysis & riding
     - short-form content (Reels, TikTok, Shorts)
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - STEPPS (Berger)
     - Hook Architecture (3-second rule)
     - MrBeast Title/Thumb Method

package/departments/landing/agents/sales-copywriter.yaml

@@ -41,6 +41,7 @@ expertise:
     - launch copy (PLF sequences)
     - objection handling in copy
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - AIDA
     - PAS (Problem-Agitate-Solve)
     - PASTOR

package/departments/marketing/agents/content-marketer.yaml

@@ -41,6 +41,7 @@ expertise:
     - content repurposing
     - brand voice writing
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - Content Pillar-Cluster
     - STEPPS (Berger)
     - Schwartz 5 Awareness Levels

package/departments/marketing/agents/growth-marketing/lifecycle-marketer.yaml

@@ -56,6 +56,7 @@ expertise:
     - dunning & payment recovery
     - deliverability & list hygiene
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - AARRR
     - RFM
     - Hooked

package/departments/marketing/agents/growth-marketing/product-marketer.yaml

@@ -59,6 +59,7 @@ expertise:
     - sales enablement collateral
     - launch messaging
   frameworks:
+    - Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep
     - Obviously Awesome
     - JTBD Four Forces
     - Schwartz 5 Levels

package/departments/quality/agents/copy-director.yaml

@@ -61,6 +61,7 @@ expertise:
     - factual accuracy in text
   frameworks:
     - Human Writing Standard
+    - Stop-Slop structural sweep
     - StoryBrand SB7
     - Schwartz Awareness Levels
     - AIDA/PAS copywriting

package/harness/codex/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.27.0 — 89 agents, 17 departments, 329 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.28.0 — 89 agents, 17 departments, 329 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.

package/harness/copilot/copilot-instructions.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.27.0 — 89 agents, 17 departments, 329 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.28.0 — 89 agents, 17 departments, 329 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.

package/harness/cursor/rules/arkaos.mdc

@@ -1,11 +1,11 @@
 ---
-description: ArkaOS v4.27.0 agent-team contract
+description: ArkaOS v4.28.0 agent-team contract
 alwaysApply: true
 ---
 
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.27.0 — 89 agents, 17 departments, 329 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.28.0 — 89 agents, 17 departments, 329 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.

package/harness/gemini/GEMINI.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.27.0 — 89 agents, 17 departments, 329 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.28.0 — 89 agents, 17 departments, 329 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.

package/harness/opencode/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.27.0 — 89 agents, 17 departments, 329 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.28.0 — 89 agents, 17 departments, 329 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.

package/harness/zed/.rules

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.27.0 — 89 agents, 17 departments, 329 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.28.0 — 89 agents, 17 departments, 329 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.

package/knowledge/agents-registry-v2.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "version": "2.0.0",
-    "generated": "2026-07-21T15:57:01.239406",
+    "generated": "2026-07-21T20:37:39.093830",
     "total_agents": 89,
     "generator": "core/agents/registry_gen.py",
     "tiers": {
@@ -779,6 +779,7 @@
         "creator monetization"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "STEPPS (Berger)",
         "Hook Architecture",
         "Content OS (GaryVee model)",
@@ -1030,6 +1031,7 @@
         "analytics & performance tracking"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "GaryVee Pillar→30+ Model",
         "Justin Welsh Content OS",
         "Platform Algorithm Signals",
@@ -1081,6 +1083,7 @@
         "webinar scripts"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "Story (McKee)",
         "Save the Cat beat sheet",
         "Dan Harmon Story Circle",
@@ -1136,6 +1139,7 @@
         "short-form content (Reels, TikTok, Shorts)"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "STEPPS (Berger)",
         "Hook Architecture (3-second rule)",
         "MrBeast Title/Thumb Method",
@@ -2725,6 +2729,7 @@
         "objection handling in copy"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "AIDA",
         "PAS (Problem-Agitate-Solve)",
         "PASTOR",
@@ -2946,6 +2951,7 @@
         "brand voice writing"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "Content Pillar-Cluster",
         "STEPPS (Berger)",
         "Schwartz 5 Awareness Levels",
@@ -2996,6 +3002,7 @@
         "deliverability & list hygiene"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "AARRR",
         "RFM",
         "Hooked",
@@ -3098,6 +3105,7 @@
         "launch messaging"
       ],
       "frameworks": [
+        "Human Writing Standard (arka-human-writing) + Stop-Slop structural sweep",
         "Obviously Awesome",
         "JTBD Four Forces",
         "Schwartz 5 Levels",
@@ -3976,6 +3984,7 @@
       ],
       "frameworks": [
         "Human Writing Standard",
+        "Stop-Slop structural sweep",
         "StoryBrand SB7",
         "Schwartz Awareness Levels",
         "AIDA/PAS copywriting"

package/knowledge/skills-manifest.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "generator": "scripts/marketplace_gen.py",
-    "version": "4.27.0",
+    "version": "4.28.0",
     "marketplace": "arkaos"
   },
   "structural": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "4.27.0",
+  "version": "4.28.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "4.27.0"
+version = "4.28.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}