Commit 2e7a4b3e by PLN (Algolia)

prose suite: slop axis (yarn slop) clustered from five anti-slop sources

scripts/slop.mjs lints blog + projects markdown against a catalog
compressed from JulienSnsnCode/anti-slop-fr, captain-marketing/
anti-slop-fr, the étape-d'après and creatoreconomy skills and the
ui-skills framework: weighted lexique/structure/servilité patterns plus
the ui-skills punctuation budgets (1 tiret cadratin per 500 words).
docs/anti-slop-research.md holds the clustering: commons with source
votes, per-source uniques, the scoring rationale and the manual gaps.
Project pages rebuilt on the blog article anatomy (80rem frame, 68ch
core); /projects/<slug>/en now serves instead of 404ing; my devname
copy rewritten to 100/100.
parent ae7d08c6
......@@ -3,11 +3,11 @@ import ProjectPage from '@/components/projects/ProjectPage';
import { PROJECT_LANGS, getAllProjectSlugs, getProject, getProjectLanguages, projectOgImage } from '@/lib/projects';
export function generateStaticParams() {
const params = getAllProjectSlugs()
.flatMap((slug) =>
PROJECT_LANGS.filter((lang) => lang !== 'en').map((lang) => ({ slug, lang })),
)
.filter(({ slug, lang }) => getProjectLanguages(slug).includes(lang));
// Every declared language mints here — including the default 'en', so
// /projects/<slug>/en answers (canonical stays /projects/<slug>).
const params = getAllProjectSlugs().flatMap((slug) =>
getProjectLanguages(slug).map((lang) => ({ slug, lang })),
);
// Static export needs at least one prerendered variant per dynamic route;
// with no published projects in prod, emit a 404 sentinel so the export
// still ships.
......@@ -18,7 +18,12 @@ export async function generateMetadata({ params }) {
const { slug, lang } = await params;
const project = await getProject(slug, lang).catch(() => null);
if (!project) return {};
const canonical = `https://me.nech.pl/projects/${slug}/${lang}`;
// The default language's canonical form lives at /projects/<slug>; other
// languages are canonical at their own URL.
const canonical =
lang === 'en'
? `https://me.nech.pl/projects/${slug}`
: `https://me.nech.pl/projects/${slug}/${lang}`;
const image = projectOgImage(slug);
return {
title: project.title,
......@@ -37,7 +42,7 @@ export async function generateMetadata({ params }) {
export default async function ProjectInLang({ params }) {
const { slug, lang } = await params;
if (lang === 'en' || !PROJECT_LANGS.includes(lang)) notFound();
if (!PROJECT_LANGS.includes(lang)) notFound();
const project = await getProject(slug, lang).catch(() => null);
if (!project) notFound();
return <ProjectPage project={project} />;
......
......@@ -8,16 +8,19 @@ import blogStyles from '@/app/blog/blog.module.css';
/** Shared detail renderer for /projects/[slug] and /projects/[slug]/[lang].
* Hero (accent bar, title, tagline, status, typed links) over the bilingual
* body in the site's canonical prose styling. */
* body in the site's canonical prose styling: an 80rem frame, inside it the
* blog article face and its centered 68ch core column. */
export default function ProjectPage({ project }) {
const accent = project.accent || 'var(--link)';
return (
<Layout>
<div className="mx-auto w-full max-w-[80rem] px-4">
<Link href="/projects" className={utilStyles.backLink}>
← All projects
</Link>
<article style={{ '--project-accent': accent }}>
<article style={{ '--project-accent': accent }} className={blogStyles.article}>
<div className={blogStyles.core}>
<header className="border-l-2 border-[var(--project-accent)] pl-4 mb-8">
<h1 className={utilStyles.headingXl}>{project.title}</h1>
{project.tagline && (
......@@ -64,7 +67,9 @@ export default function ProjectPage({ project }) {
dangerouslySetInnerHTML={{ __html: project.contentHtml }}
/>
) : null}
</div>
</article>
</div>
</Layout>
);
}
......@@ -2,7 +2,7 @@
title: devname
---
Every dev server on this machine answers at a stable name — `hindsight.localhost`, `bench.sre.localhost`, `devname.localhost` — and nobody has ever remembered a port for it.
Every dev server on this machine answers at a stable name: `hindsight.localhost`, `bench.sre.localhost`, `devname.localhost`. has ever had to remember a port.
## The idea
......@@ -60,4 +60,4 @@ options:
## The index page
Caddy also serves **devname.localhost** itself: every registered name with live up/down status, probed per request — the registry's front door, built by the same tool that keeps it.
Caddy also serves **devname.localhost** itself: every registered name with live up/down status, probed per request. The registry's front door, built by the same tool that keeps it.
......@@ -2,11 +2,11 @@
title: devname
---
Chaque serveur de dev de cette machine répond sur un nom stable — `hindsight.localhost`, `bench.sre.localhost`, `devname.localhost` — et personne n'a jamais eu à retenir un port.
Chaque serveur de dev de cette machine répond sur un nom stable : `hindsight.localhost`, `bench.sre.localhost`, `devname.localhost`. Personne n'a jamais eu à retenir un port.
## L'idée
`*.localhost` pointe vers le loopback sur tout OS moderne (RFC 6761), sans aucune configuration DNS. devname s'appuie là-dessus : **un seul Caddy** qui proxifie des noms vers des ports, un petit registre, et un CLI qui rend le tout ennuyeux — au bon sens du terme.
`*.localhost` pointe vers le loopback sur tout OS moderne (RFC 6761), sans aucune configuration DNS. devname s'appuie là-dessus : **un seul Caddy** qui proxifie des noms vers des ports, un petit registre, et un CLI qui rend le tout ennuyeux (au bon sens du terme).
```
devname ensure [projet] [--service S] [--branch auto]
......@@ -19,7 +19,7 @@ devname ensure [projet] [--service S] [--branch auto]
- Un agent launchd fait tourner Caddy sur `:80`/`:443`, lié à l'adresse wildcard (la seule façon pour un processus non privilégié de binder un port bas sur macOS).
- **Chaque site commence par un garde-fou** : toute connexion dont la source n'est pas le loopback meurt chez Caddy. Les noms restent locaux, par construction dans la config, pas par discipline.
- Le registre est un simple `names.json` ; le Caddyfile est généré à partir de lui, jamais édité à la main.
- `mkcert` émet un seul certificat SAN couvrant tous les noms enregistrés — https marche d'emblée.
- `mkcert` émet un seul certificat SAN couvrant tous les noms enregistrés : https marche d'emblée.
## Pour les agents
......@@ -30,7 +30,7 @@ PORT=$(devname ensure monapp --format port)
./monapp --port "$PORT" # maintenant sur monapp.localhost
```
Les variantes de branche ont leurs propres noms (`feat-x--tests.monapp.localhost`) — un worktree ne entre jamais en collision avec le checkout principal.
Les variantes de branche ont leurs propres noms (`feat-x--tests.monapp.localhost`) : un worktree ne entre jamais en collision avec le checkout principal.
## Tous les réglages
......@@ -60,4 +60,4 @@ options:
## La page d'index
Caddy sert aussi **devname.localhost** lui-même : tous les noms enregistrés avec leur état up/down mesuré à chaque requête — la porte d'entrée du registre, construite par l'outil qui le tient.
Caddy sert aussi **devname.localhost** lui-même : tous les noms enregistrés avec leur état up/down mesuré à chaque requête. La porte d'entrée du registre, construite par l'outil qui le tient.
# Recherche anti-slop — cinq sources, une suite multiscore
*2026-11-07. Contexte : l'axe slop de la suite prose (`yarn slop`, `scripts/slop.mjs`)
est dérivé de ce document. L'axe grammaire reste `yarn prose` (LanguageTool).*
## Les sources
| # | Source | Nature | Ce qu'elle apporte d'unique |
|---|---|---|---|
| fr1 | [JulienSnsnCode/anti-slop-fr](https://github.com/JulienSnsnCode/anti-slop-fr) | skill FR, lexique 13 catégories + structures | le lexique FR le plus fin (kitsch narratif, faux poids, anti-copule) ; notation 5 dimensions /50 |
| fr2 | [captain-marketing/anti-slop-fr](https://github.com/captain-marketing/anti-slop-fr) | skill FR, blacklist + `identity/VOICE.md` | le concept de **voix d'auteur** : les interdits génériques ne suffisent pas, il faut un profil de voix par auteur |
| étape | [letape-dapres.fr writing-unslop](https://letape-dapres.fr/ressources/skills/writing-unslop) | skill bilingue FR+EN | listes « hard replacements » FR et EN ; scoring chiffré base 100 (-5/-8/-10) |
| no-slop | [creatoreconomy.so, skill 20 patterns](https://creatoreconomy.so/p/use-my-no-ai-slop-skill-to-remove-20-ai-slop-patterns) | skill EN | la taxonomie la plus courte ; contrastes binaires, reveals au colon, fins faux-profondes |
| ui-sk | [ui-skills.com anti-ai-slop-writing](https://www.ui-skills.com/skills/jalaalrd/anti-ai-slop-writing) | framework EN | les seuls **budgets de ponctuation quantifiés** (1 tiret cadratin / 500 mots, 1 ! / 1000) ; parataxe, hedging seesaw |
Écosystème (flaviocopes [anti-slop](https://flaviocopes.com/anti-slop/)) : les skills
concurrents s'appellent `unslop`, `stop-slop` (hardikpandya, MIT — l'ancêtre cité par fr1),
`humanizer`, `deslop`. Le nôtre n'en remplace aucun : il les **compresse en linter exécutable**
pour ce repo, là où ils sont des prompts de réécriture.
## Le clustering — ce que les cinq disent ensemble
Vote = nombre de sources qui portent la règle.
| Cluster | Vote | Forme canonique |
|---|---|---|
| Tiret cadratin | **5/5** | jamais comme séparateur de proposition ; la phrase se coupe ou se colle |
| Adjectifs gonflés | 5/5 | révolutionnaire, incontournable, robuste, seamless… le fait ou rien |
| Règle de trois | 5/5 | deux éléments, ou un seul bien choisi |
| Contraste binaire (« pas X, c'est Y ») | 5/5 | dire Y directement |
| Adverbes de remplissage | 4/5 | vraiment, littéralement, fondamentalement → supprimer |
| Ouvertures à vide | 4/5 | « Soyons honnêtes », « Dans un monde où » → commencer par le fond |
| Anti-copule (constitue, serves as) | 4/5 | « est » presque toujours meilleur |
| Attribution vague | 4/5 | nommer la source ou assumer |
| Conclusions-bilans | 4/5 | finir sur un fait, pas un résumé |
| Méta-commentaire / annonce de plan | 4/5 | le texte ne se raconte pas |
| Fragments dramatiques | 3/5 | « Un mot. Un seul. » → phrase complète |
| Question-réponse (« Le problème ? ») | 3/5 | phrase affirmative |
| Faux poids (tournant, game-changer) | 3/5 | le chiffre ou l'exemple |
| Servilité / artefacts collaboratifs | 3/5 | « N'hésitez pas à », « I hope this helps » → couper |
## Ce que chaque source apporte en propre
- **fr1** : kitsch narratif (« un silence vibrant ») ; synonyme acrobatique (répéter le
mot juste) ; la vérification « un adverbe en -ment ? ».
- **fr2** : `VOICE.md` — la liste noire générique ne fait pas la voix ; les interdits
personnels et les expressions signature vivent à part. *À porter plus tard : un
`voice.md` par section du site.*
- **étape** : les listes FR/EN prêtes pour regex ; le barème chiffré.
- **no-slop** : reveals au colon (« The best part: ») ; fins faux-profondes.
- **ui-sk** : budgets quantifiés (adoptés tels quels dans le linter) ; parataxe ;
« hedging seesaw » (prendre position).
- **flaviocopes** : le slop de *code* (try/catch sur chemins sûrs, abstractions à un
appelant, casts `any`) — hors périmètre prose, à garder pour une revue code.
## Le barème retenu (`scripts/slop.mjs`)
Base 100. Lexique -5, structure -8, servilité/méta -10 ; ponctuation : -5 par
occurrence au-delà du budget (1 tiret / 500 mots, 1 `!` / 1000 mots). Le catalogue
est volontairement **haute précision** : chaque hit est un candidat relecture, pas un
verdict. Le code compte les mots hors frontmatter.
**Gaps assumés, à relire à l'œil** : règle de trois, synonyme acrobatique, variance de
longueur de phrases, parataxe — l'analyse est document-niveaux, le regex la simule mal.
**Ce que le linter ne touche jamais** (unanime des sources) : les idées, les données,
le jargon technique assumé, et la voix de l'auteur. Un « ! » dans un post joyeux de
137 mots n'est pas du slop.
......@@ -19,7 +19,8 @@
"test:e2e:ui": "playwright test --ui",
"prose": "node scripts/prose.mjs",
"og": "node scripts/og.mjs",
"fmt": "node scripts/fmt.mjs"
"fmt": "node scripts/fmt.mjs",
"slop": "node scripts/slop.mjs"
},
"engines": {
"node": ">=18.17.0"
......
#!/usr/bin/env node
/**
* yarn slop [slug|file …] — the anti-slop axis of the prose suite.
*
* Multi-score prose linting: `yarn prose` is the LanguageTool axis (grammar,
* spelling); this is the slop axis — statistically AI-flavored patterns,
* clustered from five sources (see docs/anti-slop-research.md):
*
* fr1 github.com/JulienSnsnCode/anti-slop-fr (lexique + structures)
* fr2 github.com/captain-marketing/anti-slop-fr (blacklist + voice)
* étape letape-dapres.fr/ressources/skills/writing-unslop (FR+EN lists, /100)
* no-slop creatoreconomy.so 20-pattern skill
* ui-sk ui-skills.com anti-ai-slop-writing (punctuation budgets)
*
* Scoring starts at 100; each hit costs its weight (lexique 5, structure 8,
* servile 10; punctuation charges per occurrence past the budget: one tiret
* cadratin per 500 words, one exclamation per 1000). The catalog is
* high-precision by design — every hit is a review candidate, not a verdict;
* the author's voice always wins (sources agree on this unanimement).
*
* Known gaps, deliberately manual: règle de trois, synonyme acrobatique and
* longueur-de-phrase variance need document-level analysis that regex fakes
* badly. Read the text too.
*/
import fs from 'fs';
import path from 'path';
const ROOTS = ['content/blog', 'content/projects'];
/** [id, weight, source tags, regex]. `g` flag; word boundaries mind accents. */
const CATALOG = [
// --- ouvertures à vide (fr1 §1, letape FR)
['ouverture-vide', 5, 'fr1 fr2 letape',
/\b(soyons honn[êe]tes|soyons clairs|on ne va pas se mentir|la v[ée]rit[ée],? c'est que|parlons peu,? parlons bien|il faut le dire|spoiler\s*:|petit rappel\s*:|petite pr[ée]cision\s*:|autant vous le dire tout de suite)\b/gi],
// --- décors grandioses (fr1 §2, letape FR)
['d[ée]cor grandiose', 5, 'fr1 letape',
/\b(dans un monde (t[ée]rpident|en constante [ée]volution|[a-zéèà-ÿ]+)|[àa] l'[èe]re de|[àa] l'heure [oùo]|dans le paysage (du|de la|des)|au c[œo]ur de|au coeur de|aujourd'hui plus que jamais|face aux d[ée]fis de|dans un contexte o[ùu]|dans un monde o[ùu])\b/gi],
// --- impératifs impersonnels (fr1 §5, letape FR)
['imp[ée]ratif impersonnel', 5, 'fr1 fr2 letape',
/\bil est (essentiel|important|crucial|imp[ée]ratif|int[ée]ressant) de\b|\bil convient de (noter|souligner|rappeler|pr[ée]ciser)\b|\bforce est de constater\b|\bil va sans dire\b|\bil appert que\b/gi],
// --- anti-copule (fr1 §6, letape EN "copula avoidance", flaviocopes)
['anti-copule', 5, 'fr1 letape flaviocopes',
/\b(constitue|repr[ée]sente|s'impose comme|se positionne comme|incarne|se r[ée]v[èe]le [êe]tre|t[ée]moigne de|s'inscrit dans|se veut [a-zéèà-ÿ]+|se traduit par)\b/gi],
// --- connecteurs en chaîne (fr1 §7, letape FR "Ainsi, De plus, Néanmoins")
['connecteur en d[ée]but', 5, 'fr1 letape',
/^(de plus|en outre|par ailleurs|en effet|ainsi|de ce fait|d[èe]s lors|n[ée]anmoins|cependant|toutefois|qui plus est|de surcro[îi]t|dans cette optique|[àa] cet [ée]gard)\b *[,:]?/gim],
// --- conclusions-bilans (fr1 §8, letape, no-slop)
['conclusion-bilan', 5, 'fr1 letape no-slop',
/\b(en conclusion|en r[ée]sum[ée]|en somme|en d[ée]finitive|au final|pour conclure|en bref|vous l'aurez compris|voil[àa] pour (cet|cette)|l'avenir nous le dira|seul le temps nous dira|the future isn'?t coming)\b/gi],
// --- attribution vague (fr1 §10, letape, no-slop)
['attribution vague', 8, 'fr1 letape no-slop',
/\b(les experts s'accordent|de nombreuses [ée]tudes montrent|on observe que|on constate que|il est reconnu que|il est admis que|d'aucuns|selon certains|experts (agree|argue|say)|studies show)\b/gi],
// --- faux poids (fr1 §11, letape "significance inflation")
['faux poids', 8, 'fr1 letape no-slop',
/\b(marque un tournant|moment charni[èe]re|change la donne|game-?chang(er|ing)|le potentiel est immense|les enjeux (sont )?(consid[ée]rables|[ée]normes)|un tournant d[ée]cisif|plus que jamais|stands as|is a testament to|marks a pivotal|pivotal moment)\b/gi],
// --- servilité et méta-commentaire (fr1 §12, letape "sycophancy")
['servilit[ée]/m[ée]ta', 10, 'fr1 fr2 letape no-slop',
/\b(excellente question|n'h[ée]sitez pas [àa]|n'h[ée]sitez plus|plot twist|cerise sur le g[âa]teau|dans cet article,? nous (allons|allions)|au programme\s*:|installez-?vous confortablement|c'est parti !|que vous soyez (d[ée]butant|[a-zéèà-ÿ]+) ou|i hope this (helps|this helps)|as an? (ai|assistant|language model)\b)/gi],
// --- adjectifs gonflés (fr1 §4, fr2 hyperboles, letape EN)
['adjectif gonfl[ée]', 5, 'fr1 fr2 letape flaviocopes',
/\b(incontournable|r[ée]volutionnaire|disruptif|innovant|captivant|fascinant|redoutable|holistique|granulaire|sublimer|d[ée]bloquer le potentiel|cutting-edge|groundbreaking|revolutioniz\w+|seamless\w*|robuste|robust)\b/gi],
// --- adverbes de remplissage (fr1 §9, fr2) — à relire, FP possibles
['adverbe remplissage', 3, 'fr1 fr2',
/\b(vraiment|litt[ée]ralement|fondamentalement|intrins[èe]quement|r[ée]solument|crucialement|absolument|incroyablement|extr[êe]mement|parfaitement|totalement|veritablement|v[ée]ritablement)\b/gi],
// --- contraste binaire (fr1 st§1, fr2 règle 2, letape, no-slop)
['contraste binaire', 8, 'fr1 fr2 letape no-slop flaviocopes',
/\bce n'est pas\b[^.!?]{1,90}?\b(c'est|mais)\b|[Cc]e n'est pas [^.!?]{1,60}[.!?]\s*[^\n]{0,20}\bc'est\b|not (just|merely|only)? ?[^.!?]{1,60}\bbut\b/gi],
// --- question-réponse artificielle (fr1 st§2, letape EN rhetorical openers)
['question-r[ée]ponse', 8, 'fr1 letape no-slop',
/\b(le probl[èe]me\s*\?|la bonne nouvelle\s*\?|le r[ée]sultat\s*:|r[ée]sultat\s*\?|mon conseil\s*\?|la r[ée]ponse\s*:)\b/gi],
// --- fragments dramatiques (fr1 st§3, no-slop)
['fragment dramatique', 8, 'fr1 no-slop',
/\b(un mot\.|simple\. efficace\.|c'est tout\.|that'?s it\. that'?s)\b/gi],
// --- EN lexical slop (letape EN, flaviocopes) — pour les pages EN
['EN slop lexique', 5, 'letape flaviocopes no-slop',
/\b(delve into|unpack\w*|navigate the complexit\w+|ever-changing landscape|the landscape of|synerg\w+|leverage\w*|holistic approach|it'?s worth noting|lean into|foster a culture|at the end of the day|moving forward|in today'?s world|unlock the potential|harness the power|deep dive|key takeaways|north star|double down on|at scale|boasts a|vibrant|profound)\b/gi],
];
const DASH = /—/g;
const BANG = /!/g;
function collect(slugOrFile, files, root = null) {
if (slugOrFile.endsWith('.md')) return files.push(path.resolve(slugOrFile));
for (const r of root ? [root] : ROOTS) {
const dir = path.join(process.cwd(), r, slugOrFile);
if (fs.existsSync(dir)) {
for (const f of fs.readdirSync(dir)) {
if (/^(fr|en)\.md$/.test(f)) files.push(path.join(dir, f));
}
return;
}
}
console.error(`slop: no post, project or file for "${slugOrFile}"`);
}
function bodyOf(file) {
const raw = fs.readFileSync(file, 'utf8');
const parts = raw.split('---');
return parts.length >= 3 ? parts.slice(2).join('---').trim() : raw.trim();
}
function excerpt(text, index) {
const start = Math.max(0, index - 38);
return '…' + text.slice(start, index + 52).replace(/\s+/g, ' ') + '…';
}
function lintFile(file) {
const text = bodyOf(file);
const words = text.split(/\s+/).filter(Boolean).length;
const hits = [];
let score = 100;
for (const [id, w, , re] of CATALOG) {
for (const m of text.matchAll(re)) {
hits.push({ id, w, at: excerpt(text, m.index) });
score -= w;
}
}
// Budgets de ponctuation (ui-skills): 1 tiret cadratin / 500 mots, 1 ! / 1000.
const budgets = [
[DASH, Math.max(1, Math.floor(words / 500)), 'tiret cadratin', 5],
[BANG, Math.max(1, Math.floor(words / 1000)), 'exclamation', 5],
];
for (const [re, budget, name, w] of budgets) {
const n = (text.match(re) || []).length;
for (let i = budget; i < n; i++) {
hits.push({ id: `budget ${name} (>${budget}/${words} mots)`, w, at: `occurrence ${i + 1}` });
score -= w;
}
}
return { file, words, hits, score: Math.max(0, score) };
}
const targets = process.argv.slice(2);
const files = [];
if (targets.length > 0) targets.forEach((t) => collect(t, files));
else {
for (const root of ROOTS) {
const base = path.join(process.cwd(), root);
if (!fs.existsSync(base)) continue;
for (const slug of fs.readdirSync(base)) {
const dir = path.join(base, slug);
if (fs.statSync(dir).isDirectory()) collect(slug, files, root);
}
}
}
const results = files.map(lintFile);
for (const r of results) {
const grouped = {};
for (const h of r.hits) (grouped[h.id] ??= []).push(h);
console.log(`\n== ${path.relative(process.cwd(), r.file)} — ${r.score}/100 (${r.words} mots)`);
for (const [id, list] of Object.entries(grouped)) {
console.log(` [${id}] ×${list.length} (-${list[0].w} chacun)`);
for (const h of list.slice(0, 4)) console.log(` ${h.at}`);
}
}
const worst = results.filter((r) => r.hits.length > 0).sort((a, b) => a.score - b.score);
console.log('\n---- suite multiscore ----');
for (const r of results) console.log(`${String(r.score).padStart(3)}/100 ${path.relative(process.cwd(), r.file)}`);
console.log(`\naxe slop seulement — l'axe grammaire vit dans \`yarn prose\` (LanguageTool).`);
if (worst[0]) console.log(`priorité: ${path.relative(process.cwd(), worst[0].file)} (${worst[0].score}/100)`);
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment