# ionet-ai full machine entry

Purpose: give AI search systems, answer engines, and local agents a fuller
reading map for the public `ionet-ai` knowledge base.

Public URLs:
- Human entry: https://iohao.github.io/ionet-ai/
- GitHub source: https://github.com/iohao/ionet-ai
- Small machine entry: https://iohao.github.io/ionet-ai/llms.txt
- Structured map: https://iohao.github.io/ionet-ai/ai-index.yaml
- Structured rules: https://iohao.github.io/ionet-ai/ai-rules.yaml
- Sitemap: https://iohao.github.io/ionet-ai/sitemap.xml

Repository role:
- `ionet-ai` is a local-first constrained knowledge base for `ionet`.
- It preserves governed knowledge assets, task routing, answer boundaries,
  installation rules, MCP/CLI access, and quality checklists.
- It is not a generic RAG dump and is not a model fine-tuning artifact.

Default reading order:
1. /llms.txt
2. /ai-rules.yaml
3. /ai-index.yaml
4. /README.md
5. /SKILL.md
6. /docs/architecture-summary.md
7. /docs/user-installation.md
8. /docs/knowledge-engineering-playbook.md
9. /docs/task-taxonomy-map.md
10. /docs/asset-governance.md
11. /rules/
12. /stable/
13. /candidate/
14. /checklists/
15. /references/

Authority summary:
- Use `rules/` and `stable/` as the stable authority for generation, review,
  and existing-code modification boundaries.
- Use `candidate/` only for search, diagnosis, explanation, review evidence,
  and existing-code modification evidence.
- Use `references/` for fact anchors and upstream verification entrypoints,
  not as generation patterns or templates.
- Use `docs/` for architecture, installation, governance, and knowledge
  engineering explanation.
- Use `skill-defs/` for task-family routing and context assembly lists.

High-value stable entrypoints:
- /stable/conventions/constrained-kb-authority-routing-convention.md
- /stable/checklists/constrained-kb-bootstrap-readiness-checklist.md
- /stable/faq/repository-training-not-fine-tuning-faq.md
- /stable/source-policies/upstream-version-fact-verification-policy.md
- /stable/source-policies/candidate-source-distillation-policy.md
- /stable/api-contracts/README.md

Common task routes:
- Install and use `ionet-ai`:
  /skill-defs/install-and-use/skill.yaml, /docs/user-installation.md
- Build or maintain a constrained knowledge base:
  /skill-defs/knowledge-engineering-method/skill.yaml,
  /docs/knowledge-engineering-playbook.md
- Generate an ionet Action feature:
  /skill-defs/generate-action-feature/skill.yaml,
  /stable/example-patterns/action-entry-pattern.md,
  /stable/code-templates/action-entry-template.md
- Review ionet code:
  /skill-defs/review-ionet-code/skill.yaml,
  /stable/checklists/review-ionet-code-checklist.md
- Modify existing ionet code:
  /skill-defs/modify-existing-ionet-code/skill.yaml,
  /stable/checklists/modify-existing-impact-checklist.md
- Verify latest/current ionet facts:
  /references/upstream-fact-sources.md,
  /stable/source-policies/upstream-version-fact-verification-policy.md

Do not infer:
- Do not treat candidate source analysis as direct Generate input.
- Do not infer latest upstream release facts from this repository alone.
- Do not produce version-pinned generated code unless the version was verified
  upstream or supplied by the user.
- Do not treat references as stable generation patterns or templates.
- Do not confuse `ionet-ai` repository installation with ionet framework
  dependency setup.

Crawler note:
- The public Pages site is intended to be indexable by search and AI systems.
- Host-level crawler policy is controlled by
  https://iohao.github.io/robots.txt.