# ionet-ai Summary: A local-first constrained knowledge base for ionet. It combines visible repository sources, stable generation assets, candidate review lanes, task routing, CLI/MCP access, and quality checklists for grounded answers. Start here: - /README.md: repository map, install path, runtime shape, and default reading order - /llms-full.txt: fuller public reading map for AI search and answer engines - /SKILL.md: agent-facing routing rules and answer constraints - /ai-rules.yaml: structured authority rules and answer boundaries - /ai-index.yaml: structured repository manifest for retrievers and rerankers - /docs/ai-discovery.md: public Pages, robots, sitemap, and AI crawler notes - /docs/knowledge-engineering-playbook.md: reusable knowledge-engineering method for new constrained knowledge bases - /stable/conventions/constrained-kb-authority-routing-convention.md: stable authority routing method for constrained knowledge bases - /stable/checklists/constrained-kb-bootstrap-readiness-checklist.md: stable bootstrap readiness gate for new constrained knowledge bases - /references/README.md: fact-anchor layer for upstream verification and evidence boundaries - /docs/task-taxonomy-map.md: task taxonomy and task-to-skill mapping - /docs/user-installation.md: local skill installation and MCP startup Canonical layers: - /docs: architecture, installation, task taxonomy, governance, and explanations - /rules: stable mandatory rules and negative constraints - /stable: stable concepts, conventions, patterns, templates, checklists, API contracts, anti-patterns, FAQs, and source policies - /candidate: review-only candidate notes and source analysis - /assets: starter assets and inspectable examples - /skill-defs: task family definitions and context assembly lists - /checklists: coverage, regression, and new-knowledge-base quality controls - /references: fact anchors, upstream verification entrypoints, maintainer source boundaries, and starter evidence boundaries High-frequency intents: - "install ionet-ai" -> /skill-defs/install-and-use/skill.yaml ; /docs/user-installation.md ; /README.md - "non-local install path" -> /skill-defs/install-and-use/skill.yaml ; /docs/user-installation.md ; /rules/source-scope-rules.md - "ionet framework install, project setup, IDEA VM options, Agrona UnsafeApi error, cookbook examples, quick-zero demo" -> /skill-defs/ionet-project-setup/skill.yaml ; /stable/faq/ionet-framework-installation-boundary-faq.md ; /stable/faq/current-version-selection-boundary-faq.md ; /stable/faq/ionet-runtime-vm-options-faq.md ; /stable/faq/quick-zero-demo-version-sensitive-boundary-faq.md ; /stable/checklists/ionet-project-setup-checklist.md - "new knowledge base training method" -> /skill-defs/knowledge-engineering-method/skill.yaml ; /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 ; /docs/knowledge-engineering-playbook.md - "is repository training fine-tuning" -> /stable/faq/repository-training-not-fine-tuning-faq.md ; /stable/conventions/constrained-kb-authority-routing-convention.md - "coverage gaps" -> /checklists/topic-coverage-matrix.md - "regression questions" -> /checklists/high-frequency-question-regression.md - "latest/current ionet version, JDK, dependency, Maven Central, release tag" -> /references/upstream-fact-sources.md ; /stable/faq/current-version-selection-boundary-faq.md ; /stable/source-policies/upstream-version-fact-verification-policy.md ; /rules/source-scope-rules.md - "Action generation examples" -> /checklists/high-frequency-question-regression.md ; /stable/faq/ionet-example-evidence-calibration-faq.md ; /stable/example-patterns/action-entry-pattern.md - "project structure, quick-start examples, starter shape" -> /references/starter-evidence-map.md ; /rules/project-structure-rules.md ; /stable/concepts/quick-start-structure-concept.md ; /stable/faq/quick-start-example-copy-boundary-faq.md ; /stable/anti-patterns/example-overfit-generation-anti-pattern.md - "client SDK setup, iohao-sdk, TypeScript SDK, C# SDK, GDScript SDK, Godot, Unity, Vue, Cocos" -> /skill-defs/design-interaction-contract/skill.yaml ; /stable/faq/client-sdk-target-setup-boundary-faq.md ; /stable/faq/client-sdk-example-generation-boundary-faq.md ; /stable/checklists/client-integration-contract-checklist.md - "public ionet concepts, Action, Cmd, subCmd, ExternalServer, LogicServer" -> /stable/conventions/ionet-role-vocabulary-convention.md ; /stable/concepts/action-entry-concept.md ; /stable/concepts/interaction-contract-concept.md ; /stable/concepts/external-server-boundary-concept.md ; /stable/concepts/logic-server-boundary-concept.md - "FlowContext, FlowContext broadcast design" -> /skill-defs/design-runtime-flow/skill.yaml ; /rules/flow-context-rules.md ; /stable/checklists/flow-context-runtime-scenario-checklist.md ; /stable/example-patterns/flow-context-broadcast-pattern.md ; /assets/multi-process-ionet-starter/README.md - "delayed task, cancel delayed task, CommunicationKit broadcast API" -> /stable/api-contracts/delay-taskkit-api-contract.md ; /stable/api-contracts/delay-task-api-contract.md ; /stable/api-contracts/taskkit-api-contract.md ; /stable/api-contracts/communication-kit-api-contract.md ; /stable/example-patterns/taskkit-scheduling-boundary-pattern.md - "property listener, BooleanProperty, IntegerProperty, LongProperty, ObjectProperty" -> /stable/concepts/property-listener-runtime-concept.md ; /stable/api-contracts/property-listener-api-contract.md ; /stable/checklists/property-listener-runtime-checklist.md ; /stable/faq/property-listener-boundary-faq.md - "DebugInOut, StatActionInOut, ThreadMonitorInOut, TimeRangeInOut, InOut plugin" -> /stable/conventions/inout-plugin-observability-convention.md ; /stable/api-contracts/inout-plugin-api-contract.md ; /stable/example-patterns/inout-plugin-observability-boundary-pattern.md ; /stable/checklists/inout-plugin-observability-checklist.md - "Spring integration, ActionFactoryBeanForSpring" -> /stable/concepts/spring-action-factory-integration-concept.md ; /stable/api-contracts/spring-action-factory-api-contract.md ; /stable/faq/framework-extension-boundary-faq.md ; /stable/faq/framework-integration-defaults-faq.md - "AccessAuthenticationHook, route access authentication" -> /stable/concepts/access-authentication-boundary-concept.md ; /stable/api-contracts/access-authentication-api-contract.md ; /stable/faq/access-authentication-route-boundary-faq.md ; /stable/checklists/external-access-and-cache-boundary-checklist.md - "ExternalServer builder, 对外服, 自定义对外服, MyExternalServer" -> /skill-defs/generate-framework-implementation/skill.yaml ; /rules/external-server-generation-rules.md ; /stable/code-templates/framework-implementation-template.md ; /stable/api-contracts/external-server-builder-api-contract.md ; /stable/example-patterns/framework-implementation-naming-pattern.md - "ExternalServer cache, CmdCacheOption, externalCmdCache" -> /stable/concepts/external-cmd-cache-boundary-concept.md ; /stable/api-contracts/external-cmd-cache-api-contract.md ; /stable/faq/external-cmd-cache-boundary-faq.md ; /stable/checklists/external-access-and-cache-boundary-checklist.md - "JSR380 validation, Jakarta validation, ValidatorKit, ParameterValidator" -> /stable/concepts/parameter-validation-boundary-concept.md ; /stable/api-contracts/parameter-validation-api-contract.md ; /stable/checklists/action-parameter-validation-checklist.md ; /stable/faq/validation-parameter-boundary-faq.md - "room operation, OperationHandler, RoomService" -> /stable/api-contracts/room-operation-api-contract.md ; /stable/example-patterns/room-operation-handler-pattern.md ; /stable/code-templates/room-operation-handler-template.md ; /stable/checklists/room-runtime-safety-checklist.md - "Domain Event vs EventBus, EventBus fire scope" -> /stable/concepts/domain-event-runtime-concept.md ; /stable/concepts/event-bus-runtime-concept.md ; /stable/api-contracts/domain-event-api-contract.md ; /stable/api-contracts/event-bus-api-contract.md ; /stable/faq/domain-event-vs-event-bus-faq.md - "request/multiple_response, callCollect" -> /stable/concepts/request-multiple-response-concept.md ; /stable/api-contracts/communication-logic-collect-api-contract.md ; /stable/example-patterns/request-multiple-response-collect-pattern.md ; /stable/faq/request-multiple-response-boundary-faq.md - "OnExternal, callExternal, ExternalServer extension" -> /stable/concepts/on-external-extension-concept.md ; /stable/api-contracts/on-external-api-contract.md ; /stable/api-contracts/external-communication-api-contract.md ; /stable/example-patterns/on-external-extension-pattern.md ; /stable/checklists/external-communication-boundary-checklist.md - "ExternalMessage, custom external protocol, CommunicationMessageCodec" -> /stable/concepts/external-message-protocol-concept.md ; /stable/api-contracts/external-message-api-contract.md ; /stable/faq/external-message-customization-boundary-faq.md ; /stable/checklists/external-communication-boundary-checklist.md - "JProtobuf, ProtoFileMerge, generated client code, DocumentHelper" -> /stable/conventions/proto-generation-convention.md ; /stable/api-contracts/proto-generation-api-contract.md ; /stable/api-contracts/document-codegen-api-contract.md ; /stable/example-patterns/proto-codegen-boundary-pattern.md ; /stable/checklists/proto-codegen-boundary-checklist.md ; /stable/faq/client-sdk-target-setup-boundary-faq.md - "OneApplication, OneApplication startup chain" -> /skill-defs/design-server-boundary/skill.yaml ; /rules/one-application-rules.md ; /stable/example-patterns/one-application-pattern.md ; /stable/code-templates/one-application-template.md ; /stable/checklists/one-application-checklist.md - "generate Action" -> /skill-defs/generate-action-feature/skill.yaml ; /stable/example-patterns/action-entry-pattern.md ; /stable/code-templates/action-entry-template.md - "Action primitive parameter, Action List return, protocol fragment" -> /stable/api-contracts/action-method-signature-api-contract.md ; /stable/checklists/protocol-fragment-boundary-checklist.md ; /stable/faq/protocol-fragment-boundary-faq.md - "DataCodec, DataCodecManager, business data protocol, JSON codec" -> /stable/api-contracts/data-codec-api-contract.md ; /stable/checklists/protocol-fragment-boundary-checklist.md - "review ionet code" -> /skill-defs/review-ionet-code/skill.yaml ; /stable/checklists/review-ionet-code-checklist.md - "review or modify existing Action route, Message field, or protocol change" -> /skill-defs/review-ionet-code/skill.yaml ; /skill-defs/modify-existing-ionet-code/skill.yaml ; /stable/checklists/review-ionet-code-checklist.md ; /stable/checklists/modify-existing-impact-checklist.md ; /checklists/high-frequency-question-regression.md - "candidate source analysis Generate boundary" -> /stable/source-policies/candidate-source-distillation-policy.md ; /stable/faq/candidate-source-analysis-generate-boundary-faq.md ; /stable/architecture-decisions/candidate-source-analysis-generate-boundary-decision.md ; /stable/anti-patterns/candidate-note-wholesale-promotion-anti-pattern.md - "weak or partial coverage downgrade" -> /checklists/topic-coverage-matrix.md ; /checklists/high-frequency-question-regression.md ; /stable/conventions/constrained-kb-authority-routing-convention.md Authority rules: - Use /rules and /stable for Generate, Review, and ModifyExisting constraints. - Use /candidate for search, diagnosis, explanation, review, and modify-existing evidence only. - Use /assets for starter-aware structure and inspectable examples. - Use /docs for explanation, installation, governance, and method. - Use /checklists for coverage, regression, and bootstrap quality gates. - Use /references for fact anchors and source verification entrypoints; do not use it as Generate pattern or template input. - Use /skill-defs/ionet-project-setup/skill.yaml for ionet framework setup; use /skill-defs/install-and-use/skill.yaml only for ionet-ai repository installation. Do not infer: - Do not treat candidate source analysis as stable Generate input. - Do not invent ionet APIs when no stable source or asset supports them. - Prefer /stable/api-contracts for common framework method signatures before re-inspecting jars. - Do not infer a non-local install path from this repository. - Do not confuse ionet framework dependency setup with ionet-ai repository installation. - Do not treat this repository as the only source for latest upstream release facts. - Do not claim current JDK, dependency, Maven Central, or release facts from cached local docs alone. - Do not produce version-pinned generated code unless the version was verified upstream or supplied by the user.