Skip to content

docs: slim AGENTS.md and move long policies to skills/docs - #674

Merged
alexis900 merged 2 commits into
developfrom
docs/agents-md-and-ci
Oct 11, 2026
Merged

alexis900 merged 2 commits into
developfrom
docs/agents-md-and-ci

Conversation

@alexis900

@alexis900 alexis900 commented Oct 11, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

AGENTS.md pasa de 419 a 248 líneas sin perder ninguna regla: las políticas largas se mueven a su sitio y quedan punteros. Además corrige una dependencia prohibida que tenía neodev check-deps en rojo.

CI: no entra aquí. El CI es de la toolchain (neodev), no de NeoDOS, y vive en NeoDev#38 / PR NeoDOS-Project/NeoDev#39.

Implemented

  • AGENTS.md resumido (419 → 248 líneas).
    • Política de validación del scheduler (68 l) → skills/scheduler/SKILL.md.
    • Proactive Capability Discovery (119 l) → docs/development/capability-discovery.md, indexado en docs/README.md.
    • Sección GitHub de-duplicada: la regla 13 (criterios de aceptación) estaba repetida en 3 sitios.
    • Reglas 1-13 y sección graphify intactas.
  • Violation de la regla 12 corregido. drivers/mod.rs importaba fs::vfs::mount::MountManager desde un test → dependencia drivers → fs/vfs. El test se mueve a fs/vfs/mount.rs como vfs_mount_manager_consistent (donde MountManager es local y register_mount_tests() ya se ejecuta). Cobertura intacta, baseline sin crecer.

Verification

Ejecutado en local:

  • neodev check-deps → verde (No new dependency violations (142 baselined))
  • scripts/check-skills.sh → OK (18 skills)
  • markdownlint sobre todos los .md tocados → exit 0

No ejecutado: cargo build / neodev test / VM (regla 1: solo con petición explícita). El movimiento del test está revisado por lectura pero no compilado localmente.

Discovered Capabilities

  • El baseline de markdownlint está roto en develop: 81 errores en 11 ficheros (10 de ellos docs/investigation/).

Existing Issues

Follow-up Work

  • Arreglar el baseline de markdownlint en docs/investigation/ si se quiere lintear markdown de forma global.

- Scheduler validation policy -> skills/scheduler/SKILL.md (full text)
- Proactive Capability Discovery -> docs/development/capability-discovery.md
- AGENTS.md de-duplicates the GitHub workflow; keeps rules + short pointers
- docs/README.md indexes the new document; CHANGELOG entry added
`drivers/mod.rs` imported `fs::vfs::mount::MountManager` from a test, a
drivers -> fs/vfs dependency that broke rule 12 (dependencies flow only
downward) and left `neodev check-deps` red with a new violation.

Move the test to `fs/vfs/mount.rs` as `vfs_mount_manager_consistent`,
where `MountManager` is local and the registration (`register_mount_tests`)
already runs. Coverage is unchanged and `check-deps-baseline.txt` does not
grow.

Verified: neodev check-deps -> OK (142 baselined); scripts/check-skills.sh -> OK.
@alexis900
alexis900 force-pushed the docs/agents-md-and-ci branch from bc8e010 to d5186ac Compare October 11, 2026 08:23
@alexis900 alexis900 changed the title docs+ci: slim AGENTS.md and add a compile-oriented CI workflow docs: slim AGENTS.md and move long policies to skills/docs Oct 11, 2026
@alexis900
alexis900 merged commit 0c09aee into develop Oct 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant