[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7A3V69T0G197NP2ME4DB6CD":3,"skill-same:01M7A3V69T0G197NP2ME4DB6CD":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M7A3V69T0G197NP2ME4DB6CD","iakaframe-humandoc",null,"Publier\u002Frafraîchir la mémoire humaine d'un projet dans \u003CDOC_TOOL> auto-hébergé — un espace par projet, une vue d'ensemble + une sous-page par doc structurant (CLAUDE.md, specs\u002FPROJET.md, specs\u002Finstructions\u002F*, specs\u002Fetat-des-lieux.md, docs\u002Fqualite\u002F*). À utiliser quand il faut \"documenter le projet dans \u003CDOC_TOOL>\", \"mettre à jour la mémoire humaine\", \"publier les specs dans \u003CDOC_TOOL>\". Idempotent et non destructif.","iakasju\u002Fiakaframe","iakasju","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F312920133?v=4","01M7A3NER2WDEC6BJVYFXEJJX7","01M7A3NERP9PTXN6CHYP42NCHS",0,"MIT","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Fframes\u002Freleases\u002FStefFrame2\u002Fskills\u002Fiakaframe-humandoc\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nid: iakaframe-humandoc\nname: iakaframe-humandoc\ndescription: Publier\u002Frafraîchir la mémoire humaine d'un projet dans \u003CDOC_TOOL> auto-hébergé — un espace par projet, une vue d'ensemble + une sous-page par doc structurant (CLAUDE.md, specs\u002FPROJET.md, specs\u002Finstructions\u002F*, specs\u002Fetat-des-lieux.md, docs\u002Fqualite\u002F*). À utiliser quand il faut \"documenter le projet dans \u003CDOC_TOOL>\", \"mettre à jour la mémoire humaine\", \"publier les specs dans \u003CDOC_TOOL>\". Idempotent et non destructif.\n---\n\n# iakaframe — doc-doc\n\nExécuteur machine de la **mémoire humaine** \u003CDOC_TOOL> (cf. `methode-de-travail.md` →\n« Cycle de documentation → Mémoire humaine »). Publie\u002Frafraîchit les **docs structurants**\nd'un projet dans une instance \u003CDOC_TOOL> auto-hébergée, par instrumentation, sans geste manuel.\n\n> **Action récurrente portée par 📖 Nathalie** (gardienne de la mémoire humaine du projet).\n> C'est sa skill-outil ; elle la déclenche aux moments de documentation (version, pause\u002Freprise).\n\nLe CLI `humandoc.mjs` est **Node pur, zéro dépendance** (`fetch` natif) : pas de\n`npm install`, fonctionne tel quel partout où Node ≥ 18 est présent.\n\n## Modèle de données (tranché avec le décideur)\n\n- **Un espace \u003CDOC_TOOL> par projet** (nommé d'après le projet).\n- Dans cet espace : **une page « Vue d'ensemble »** (synthèse + inventaire des sous-pages).\n- **Une sous-page par doc structurant**, nommée d'après le **chemin relatif** du fichier.\n- **Docs structurants** : `CLAUDE.md`, `specs\u002FPROJET.md`, `specs\u002Finstructions\u002F*.md`,\n  `specs\u002Fetat-des-lieux.md`, `docs\u002Fqualite\u002F*.md`. **Jamais le code ni les fichiers générés.**\n\n## Identifiants (résolution en cascade — jamais commités)\n\nLes trois identifiants sont résolus dans cet ordre, **l'env ayant toujours priorité** :\n\n1. **Variables d'env** : `DOC_URL`, `DOC_EMAIL`, `DOC_PASSWORD`.\n2. **Repli fichier** : pour toute variable **encore absente** de l'env, lecture d'un fichier\n   dotenv local — `$IAKAFRAME_DOC_ENV` s'il est défini, sinon\n   `~\u002F.config\u002Fiakaframe\u002Fdoc.env`. Fichier absent\u002Fillisible → ignoré silencieusement.\n\nCe repli permet de fonctionner dans une session fraîche (ex. Claude Desktop) où les variables\nd'env ne sont pas exportées, sans jamais mettre de secret dans le code.\n\n| Variable | Rôle |\n|---|---|\n| `DOC_URL` | base de l'instance \u003CDOC_TOOL> (ex. `\u003CDOC_URL>`) |\n| `DOC_EMAIL` | compte \u003CDOC_TOOL> |\n| `DOC_PASSWORD` | mot de passe |\n\n**Format du fichier** (`KEY=VALUE`, un par ligne ; `#` = commentaire ; quotes entourantes\noptionnelles) :\n\n```\nDOC_URL=http:\u002F\u002Fhost:port\nDOC_EMAIL=email\nDOC_PASSWORD=motdepasse\n```\n\n> **Sécurité** : `chmod 600 ~\u002F.config\u002Fiakaframe\u002Fdoc.env`, **jamais commité** (ni le\n> fichier, ni son contenu). Si après la cascade une valeur manque encore, message net citant\n> **et** les variables d'env **et** le chemin du fichier attendu, code de sortie non nul.\n\n## Utilisation\n\n```bash\nnode humandoc.mjs --project \u003Cvotre-projet> --root \u003CPROJECT_ROOT>\n```\n\nRésout les docs structurants présents sous `--root`, garantit l'espace `--project`,\ncrée\u002Fmet à jour la vue d'ensemble + une sous-page par fichier. Le script est dans le\ndossier de cette skill (`humandoc.mjs`).\n\n## Idempotence & non-destructivité\n\n- **Espace** : réutilisé par nom s'il existe, créé sinon (jamais de doublon).\n- **Pages** : la mise à jour = mise en corbeille de l'ancienne page + recréation du contenu\n  frais (l'API n'expose pas de remplacement in-place ; les pages en corbeille disparaissent\n  de l'arbre, donc la recherche par nom reste propre). **Relancer deux fois = même état.**\n- Ne touche jamais aux espaces\u002Fpages hors périmètre du projet.\n\n## Mécanismes API (vérifiés en réel, spike 2026-07-01)\n\n1. Auth : `POST {base}\u002Fgotrue\u002Ftoken?grant_type=password` → `access_token` (~2 h).\n2. Provision idempotente : `GET {base}\u002Fapi\u002Fuser\u002Fverify\u002F{token}`.\n3. Workspace : `GET {base}\u002Fapi\u002Fworkspace` → `data[0].workspace_id`.\n4. Arbre : `GET {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Ffolder?depth=N`.\n5. Créer un **espace** : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fspace`\n   `{name, space_permission, space_icon, space_icon_color}` → `view_id` (`is_space:true`).\n6. Créer une page : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fpage-view`\n   `{parent_view_id, layout:0, name}`.\n7. Écrire le contenu : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fpage-view\u002F{vid}\u002Fappend-block`\n   `{\"blocks\":[{\"type\":\"paragraph\",\"data\":{\"delta\":[{\"insert\":\"texte\"}]}}]}`.\n8. Mise à jour : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fpage-view\u002F{vid}\u002Fmove-to-trash`\n   (pas de `DELETE` : renvoie 405).\n\n## Mise en forme\n\nMVP = **paragraphes texte fidèles** (un paragraphe par ligne). Titres\u002Flistes\u002Fblocs de code\nMarkdown fidèles = **différé** (cf. instruction).\n\n## Échec propre\n\nConfig absente, instance injoignable, auth refusée → **message net + code de sortie non nul**,\nsans stacktrace et **sans bloquer** le flux appelant. Token expiré → ré-auth automatique.\nFichier illisible → ignoré proprement.\n\n## Tests\n\n`node test.mjs` — tests unitaires des fonctions **pures** (résolution des docs, mapping\nfichier → blocs, parsing d'arguments, **parseur dotenv** `parseDotenv`) ; le HTTP et l'I\u002FO\nfichier d'identifiants sont mockés\u002Févités (fixtures bidon, **aucun secret réel**). La recette réelle se fait\nmanuellement contre l'instance avec un projet de test, puis nettoyage.\n\n## Hors périmètre (différé tracé)\n\n- Branchement auto dans `iakaframe-update.ps1` \u002F snapshot (la skill est appelable ; le câblage\n  aux moments version\u002Fpause\u002Freprise est un lot suivant).\n- Rendu riche Markdown (titres, listes, code) au-delà du paragraphe.\n- Liens cliquables vue d'ensemble → sous-pages (MVP = inventaire texte).\n- Secret au keychain (MVP = env, repli fichier dotenv local).\n","# iakaframe — doc-doc\n\nExécuteur machine de la **mémoire humaine** \u003CDOC_TOOL> (cf. `methode-de-travail.md` →\n« Cycle de documentation → Mémoire humaine »). Publie\u002Frafraîchit les **docs structurants**\nd'un projet dans une instance \u003CDOC_TOOL> auto-hébergée, par instrumentation, sans geste manuel.\n\n> **Action récurrente portée par 📖 Nathalie** (gardienne de la mémoire humaine du projet).\n> C'est sa skill-outil ; elle la déclenche aux moments de documentation (version, pause\u002Freprise).\n\nLe CLI `humandoc.mjs` est **Node pur, zéro dépendance** (`fetch` natif) : pas de\n`npm install`, fonctionne tel quel partout où Node ≥ 18 est présent.\n\n## Modèle de données (tranché avec le décideur)\n\n- **Un espace \u003CDOC_TOOL> par projet** (nommé d'après le projet).\n- Dans cet espace : **une page « Vue d'ensemble »** (synthèse + inventaire des sous-pages).\n- **Une sous-page par doc structurant**, nommée d'après le **chemin relatif** du fichier.\n- **Docs structurants** : `CLAUDE.md`, `specs\u002FPROJET.md`, `specs\u002Finstructions\u002F*.md`,\n  `specs\u002Fetat-des-lieux.md`, `docs\u002Fqualite\u002F*.md`. **Jamais le code ni les fichiers générés.**\n\n## Identifiants (résolution en cascade — jamais commités)\n\nLes trois identifiants sont résolus dans cet ordre, **l'env ayant toujours priorité** :\n\n1. **Variables d'env** : `DOC_URL`, `DOC_EMAIL`, `DOC_PASSWORD`.\n2. **Repli fichier** : pour toute variable **encore absente** de l'env, lecture d'un fichier\n   dotenv local — `$IAKAFRAME_DOC_ENV` s'il est défini, sinon\n   `~\u002F.config\u002Fiakaframe\u002Fdoc.env`. Fichier absent\u002Fillisible → ignoré silencieusement.\n\nCe repli permet de fonctionner dans une session fraîche (ex. Claude Desktop) où les variables\nd'env ne sont pas exportées, sans jamais mettre de secret dans le code.\n\n| Variable | Rôle |\n|---|---|\n| `DOC_URL` | base de l'instance \u003CDOC_TOOL> (ex. `\u003CDOC_URL>`) |\n| `DOC_EMAIL` | compte \u003CDOC_TOOL> |\n| `DOC_PASSWORD` | mot de passe |\n\n**Format du fichier** (`KEY=VALUE`, un par ligne ; `#` = commentaire ; quotes entourantes\noptionnelles) :\n\n```\nDOC_URL=http:\u002F\u002Fhost:port\nDOC_EMAIL=email\nDOC_PASSWORD=motdepasse\n```\n\n> **Sécurité** : `chmod 600 ~\u002F.config\u002Fiakaframe\u002Fdoc.env`, **jamais commité** (ni le\n> fichier, ni son contenu). Si après la cascade une valeur manque encore, message net citant\n> **et** les variables d'env **et** le chemin du fichier attendu, code de sortie non nul.\n\n## Utilisation\n\n```bash\nnode humandoc.mjs --project \u003Cvotre-projet> --root \u003CPROJECT_ROOT>\n```\n\nRésout les docs structurants présents sous `--root`, garantit l'espace `--project`,\ncrée\u002Fmet à jour la vue d'ensemble + une sous-page par fichier. Le script est dans le\ndossier de cette skill (`humandoc.mjs`).\n\n## Idempotence & non-destructivité\n\n- **Espace** : réutilisé par nom s'il existe, créé sinon (jamais de doublon).\n- **Pages** : la mise à jour = mise en corbeille de l'ancienne page + recréation du contenu\n  frais (l'API n'expose pas de remplacement in-place ; les pages en corbeille disparaissent\n  de l'arbre, donc la recherche par nom reste propre). **Relancer deux fois = même état.**\n- Ne touche jamais aux espaces\u002Fpages hors périmètre du projet.\n\n## Mécanismes API (vérifiés en réel, spike 2026-07-01)\n\n1. Auth : `POST {base}\u002Fgotrue\u002Ftoken?grant_type=password` → `access_token` (~2 h).\n2. Provision idempotente : `GET {base}\u002Fapi\u002Fuser\u002Fverify\u002F{token}`.\n3. Workspace : `GET {base}\u002Fapi\u002Fworkspace` → `data[0].workspace_id`.\n4. Arbre : `GET {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Ffolder?depth=N`.\n5. Créer un **espace** : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fspace`\n   `{name, space_permission, space_icon, space_icon_color}` → `view_id` (`is_space:true`).\n6. Créer une page : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fpage-view`\n   `{parent_view_id, layout:0, name}`.\n7. Écrire le contenu : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fpage-view\u002F{vid}\u002Fappend-block`\n   `{\"blocks\":[{\"type\":\"paragraph\",\"data\":{\"delta\":[{\"insert\":\"texte\"}]}}]}`.\n8. Mise à jour : `POST {base}\u002Fapi\u002Fworkspace\u002F{wid}\u002Fpage-view\u002F{vid}\u002Fmove-to-trash`\n   (pas de `DELETE` : renvoie 405).\n\n## Mise en forme\n\nMVP = **paragraphes texte fidèles** (un paragraphe par ligne). Titres\u002Flistes\u002Fblocs de code\nMarkdown fidèles = **différé** (cf. instruction).\n\n## Échec propre\n\nConfig absente, instance injoignable, auth refusée → **message net + code de sortie non nul**,\nsans stacktrace et **sans bloquer** le flux appelant. Token expiré → ré-auth automatique.\nFichier illisible → ignoré proprement.\n\n## Tests\n\n`node test.mjs` — tests unitaires des fonctions **pures** (résolution des docs, mapping\nfichier → blocs, parsing d'arguments, **parseur dotenv** `parseDotenv`) ; le HTTP et l'I\u002FO\nfichier d'identifiants sont mockés\u002Févités (fixtures bidon, **aucun secret réel**). La recette réelle se fait\nmanuellement contre l'instance avec un projet de test, puis nettoyage.\n\n## Hors périmètre (différé tracé)\n\n- Branchement auto dans `iakaframe-update.ps1` \u002F snapshot (la skill est appelable ; le câblage\n  aux moments version\u002Fpause\u002Freprise est un lot suivant).\n- Rendu riche Markdown (titres, listes, code) au-delà du paragraphe.\n- Liens cliquables vue d'ensemble → sous-pages (MVP = inventaire texte).\n- Secret au keychain (MVP = env, repli fichier dotenv local).\n",{"id":5,"name":5,"description":7},"main","2c823d6ebe5ebfb7731a2866ffc7c74a9841a565","frames\u002Freleases\u002FStefFrame2\u002Fskills\u002Fiakaframe-humandoc","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe","https:\u002F\u002Fgithub.com\u002Fiakasju","2026-10-12 02:34:33",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add iakasju\u002Fiakaframe --skill iakaframe-humandoc",{"tool":35,"command":36},"bunx","bunx skills add iakasju\u002Fiakaframe --skill iakaframe-humandoc",{"tool":38,"command":39},"pnpm","pnpm dlx skills add iakasju\u002Fiakaframe --skill iakaframe-humandoc","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Fframes\u002Freleases\u002FStefFrame2\u002Fskills\u002Fiakaframe-humandoc\u002FSKILL.md",true,[],[44,50,56,62,68,74],{"skillNo":45,"name":46,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":47,"categories":48,"keywords":49,"publishedAt":18},"01M7A425YF6X4NDVXA20QWDMZ6","waterfall-verification-validation","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Flibrary\u002Fskills\u002Fwaterfall-verification-validation\u002FSKILL.md",[],[],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7A422X8142T71FKPHSYSP83","waterfall-requirements-engineering","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Flibrary\u002Fskills\u002Fwaterfall-requirements-engineering\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7A41ZXA07D0XZH89EJKYMA1","waterfall-phase-governance","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Flibrary\u002Fskills\u002Fwaterfall-phase-governance\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7A41X6Y2XP27Q5VK592C9F5","waterfall-construction","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Flibrary\u002Fskills\u002Fwaterfall-construction\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7A41T3Y5JNNJGHZZXDVYV6W","waterfall-architecture-design","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Flibrary\u002Fskills\u002Fwaterfall-architecture-design\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7A41QNJJNZ31YFMAZ1FP236","shapeup-shaping","https:\u002F\u002Fgithub.com\u002Fiakasju\u002Fiakaframe\u002Fblob\u002Fmain\u002Flibrary\u002Fskills\u002Fshapeup-shaping\u002FSKILL.md",[],[]]