arkaos 4.26.0 → 4.28.0

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/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