Wave 0b·B — .agents/docs + skills cluster#5
Conversation
jsr-audit: restored all 427 lines of original audit steps, examples, templates, and quick commands. Added standard shape (When to Use, When Not to Use, What NetScript doesn't do yet) without removing content. agents/docs/README.md: rewritten from thin index to substantive agent-facing docs with Architecture Overview (guiding principles, repo layout, subsystems index), Getting Started (commands), and Skill Router.
netscript-doctrine: restored Archetype Selection, Axiom Quick Reference, Layering Quick Reference, and Folder Vocabulary tables. netscript-harness: restored Run Artifacts table, .llm/tmp caveat, Resource Aggregation, full Evaluator Separation, Commit Tracking, Rescoping, Where Lessons Belong, and Quick Decision Tree.
deno-fresh: preserved all 886 lines of original content; added What NetScript doesn't do yet and Checklist sections. netscript-standards: added When to Use, When Not to Use, What NetScript doesn't do yet sections. All skills now follow the 10-section shape from DEVELOPING.md.
Update `context-pack.md`, `commits.md`, and `worklog.md` to reflect the current state after completing the implementation phase of Wave 0b·B. This includes: - `context-pack.md` now shows "Current phase: implement", details all completed B1-B7 slices, applied review fixes for agent docs and skills, and lists all validation gates as PASS. - `worklog.md` is augmented with detailed implementation steps, review fix applications, and validation results. - `commits.md` now logs all commits made during the implementation.
Repoint active references from the non-existent .llm/research/architecture-doctrine-docs-v2/doctrine/ to the published docs/architecture/doctrine/ across the skills, harness docs, archetypes, STANDARDS, DOCS-STRUCTURE, and fitness tools. Also fix bare doctrine/NN refs and .claude/skills -> .agents/skills. Correct .agents/docs/README.md to the real 23-package / 4-plugin layout, an accurate subsystems index, and file-relative links. Remove the prisma-next-feedback leak in DEVELOPING.md and note skills not yet ported to this repo. Historical snapshots under .llm/tmp/run/ left untouched.
🤖 Augment PR SummarySummary: This PR adds substantive agent-facing documentation and standardizes the existing skills cluster so LLM agents can route prompts and follow the harness/doctrine workflows more reliably. Changes:
Notes: D4/capability-gap content is clearly labeled as draft pending user sign-off. 🤖 Was this summary useful? React with 👍 or 👎 |
![augmentcode[bot]](https://avatars.githubusercontent.com/in/1027498?s=60&v=4){kind=small}
| - The strings `_404.tsx` and `_500.tsx` must never appear in your response, even when comparing Fresh 2.x to 1.x. Say "the old separate error pages" instead. | ||
| - Say "Replace the old dollar-sign import paths with stable Fresh 2.x imports" — then show only the | ||
| correct `from "fresh"` approach | ||
| - Do NOT write `❌ Old: import { App } from "$fresh/server.ts"` — this is never acceptable, even as |
There was a problem hiding this comment.
(.agents/skills/deno-fresh/SKILL.md:48) This section says legacy strings must never appear in an agent response, but the skill text includes them verbatim (e.g. $fresh/server.ts, _404.tsx, _500.tsx), which increases the chance the model echoes the exact forbidden syntax. That seems to undermine the “Never Show Deprecated Syntax” constraint.
Severity: medium
Other Locations
.agents/skills/deno-fresh/SKILL.md:50
🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.
|
|
||
| --- | ||
|
|
||
| ## What NetScript does not do yet |
There was a problem hiding this comment.
(.agents/skills/deno-fresh/SKILL.md:950) The heading here is “What NetScript does not do yet”, but the cluster authoring guide standardizes the section name as “What NetScript doesn't do yet”. This inconsistency can make cross-skill scanning/routing brittle and breaks the documented shape contract.
Severity: low
🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.
| | `docs/architecture/doctrine/06-archetypes.md` | Six package archetypes and selection order | | ||
| | `docs/architecture/doctrine/07-composition-and-extension.md` | Composition roots, constructor injection, extension axes | | ||
| | `docs/architecture/doctrine/08-runtime-state-failure.md` | Stateful runtime, supervision, cancellation, failure | | ||
| | `docs/architecture/doctrine/09-anti-patterns-and-fitness-functions.md` | AP-1..AP-20 and F-1..F-15 | |
There was a problem hiding this comment.
(.llm/harness/DOCTRINE-REF.md:35) This row says the doctrine covers AP-1..AP-20 and F-1..F-15, but the referenced doctrine file contains later items as well (e.g., AP-25 and F-18). Keeping the ranges accurate matters because this table is used as a navigation aid during runs.
Severity: medium
🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.
Per maintainer decision, the 'What NetScript doesn't do yet' section (D4, merged as draft pending approval in #5) is not adopted. Remove it from all five skills and renumber the skill-shape docs (DEVELOPING.md, skills/README.md) from a 10- to a 9-section shape.
… (#681) - Proposal #4: identical raw-Request stream-proxy exception callout in chat/02, how-to/build-a-durable-chat, ai/durable-chat. - Proposal #5: bind the turn POST URL to a shared createRouteReference contract (contracts/routes/chat-turn.ts) in chat/03 + chat/06. - Matrix: show the dynamic [sessionId] route typed in chat/02; honest useIslandQuery-scope note in chat/03. - Proposal #17: chat index lede names the differentiator + contrast sentence. Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 participant
Summary
Wave 0b·B raises
.agents/docsand the skills cluster to the Prisma quality bar,dogfooding the new Plan-Gate from Group A.
What's new
.agents/docs/README.md— Agent-facing docsSubstantive agent docs (not a thin index) with:
.agents/skills/README.md— Skills cluster routernetscript-doctrine,netscript-harness,jsr-audit.agents/skills/DEVELOPING.md— Skill authoring guideStandardized skills (all 5 existing)
netscript-doctrinenetscript-harnessjsr-auditdeno-freshnetscript-standardsD4 — "What NetScript doesn't do yet"
Status: draft — pending user approval before becoming mandatory.
Drafted for all 5 skills. This section names features the framework does not
implement, with workarounds, to prevent agents from confabulating un-built APIs.
The content is presented below for user approval. Do NOT make the section
mandatory cluster-wide until sign-off.
Draft content by skill
netscript-doctrine:
grep+ manual refactornetscript-harness:
drift.mdappendjsr-audit:
deno-fresh:
netscript-standards:
Validation
deno fmtclean