Guidance Files

Knowns uses lightweight compatibility files for AI runtimes that auto-detect repository instruction files. These files should be small entrypoints that tell the assistant to start with Knowns MCP initial and use on-demand help for tool schemas and workflow guidance.

Runtime-critical guidance lives in MCP initial and help, not in a large repository prompt file. This lets Knowns update agent behavior without requiring every repository to change generated markdown.

Compatibility files

CLAUDE.md
OPENCODE.md
GEMINI.md
AGENTS.md
.github/copilot-instructions.md

Refresh generated content

bash

knowns init
knowns setup agents
knowns setup --global
knowns sync
knowns sync --instructions

Use knowns init to create the initial project state and selected lightweight shims. Use knowns setup agents to create or refresh generic repo-local shims, knowns setup <target> --global for normal personal platform integrations, or knowns sync to refresh generated files from config.

Agent bootstrap

At session start, the assistant should:

call MCP initial
use help("tool.*") or help("workflow.*") when it needs details
use CLI commands only as a fallback when MCP is unavailable

Guidance files

Knowns dùng lightweight compatibility files cho AI runtimes có cơ chế auto-detect repository instruction files. Các file này chỉ nên là entrypoint nhỏ, yêu cầu assistant bắt đầu bằng Knowns MCP initial và dùng on-demand help để xem tool schemas và workflow guidance.

Runtime-critical guidance nằm trong MCP initial và help, không nằm trong một repository prompt file lớn. Cách này giúp Knowns update agent behavior mà không bắt mọi repository phải đổi generated markdown.

Compatibility files

CLAUDE.md
OPENCODE.md
GEMINI.md
AGENTS.md
.github/copilot-instructions.md

Refresh

bash

knowns init
knowns setup agents
knowns setup --global
knowns sync
knowns sync --instructions

Dùng knowns init để tạo project state ban đầu và selected lightweight shims. Dùng knowns setup agents để tạo hoặc refresh generic repo-local shims, knowns setup <target> --global cho personal platform integrations thông thường, hoặc knowns sync để refresh generated files từ config.

Agent bootstrap

Khi bắt đầu session, assistant nên:

gọi MCP initial
dùng help("tool.*") hoặc help("workflow.*") khi cần chi tiết
chỉ dùng CLI command làm fallback khi MCP không khả dụng