docs: describe shared rule manifest
This commit is contained in:
1 parent
d308bc037e
commit
3ddf2756c2
3 files changed
+4
-4
No files matched your search
@@ -267,7 +267,7 @@ workspace-scoped and use automatic review for eligible escalation requests. Ever
|
|||||||
|
|
||||||
Claude Code receives the equivalent global instructions, agents, hooks, and `settings.json`. General rules are embedded
|
Claude Code receives the equivalent global instructions, agents, hooks, and `settings.json`. General rules are embedded
|
||||||
once in `CLAUDE.md` (and in Codex's `AGENTS.md`); every technology- or
|
once in `CLAUDE.md` (and in Codex's `AGENTS.md`); every technology- or
|
||||||
situation-specific rule (`adapters/claude/rule-skills.tsv`) is generated as a skill under `skills/rules/` instead, so
|
situation-specific rule (`adapters/rule-skills.tsv`) is generated as a skill under `skills/rules/` instead, so
|
||||||
only its name and description are permanently visible and the full rule text loads only when Claude invokes it. Its
|
only its name and description are permanently visible and the full rule text loads only when Claude invokes it. Its
|
||||||
generated settings use the supported automatic permission mode where available.
|
generated settings use the supported automatic permission mode where available.
|
||||||
|
|
||||||
@@ -296,7 +296,7 @@ turning yellow at 60% and red at 85%; its status-line input does not expose the
|
|||||||
### Add a rule
|
### Add a rule
|
||||||
|
|
||||||
Create a focused Markdown file in `shared/rules/`. For a rule that applies only to a language, framework, tool, or
|
Create a focused Markdown file in `shared/rules/`. For a rule that applies only to a language, framework, tool, or
|
||||||
change area, add one row to `adapters/claude/rule-skills.tsv`. The build uses that manifest to generate both Claude's
|
change area, add one row to `adapters/rule-skills.tsv`. The build uses that manifest to generate both Claude's
|
||||||
rule skill and Codex's rule-loading condition. Put always-applicable guidance in `general.md`, which the build embeds
|
rule skill and Codex's rule-loading condition. Put always-applicable guidance in `general.md`, which the build embeds
|
||||||
for both clients; a new rule file is not automatically embedded.
|
for both clients; a new rule file is not automatically embedded.
|
||||||
|
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
Codex receives a generated global `AGENTS.md`, agent TOML files, skills, rule files, and a `config.toml` adapter. It keeps workspace sandboxing, automatic approval review, `agents.enabled = true`, `agents.max_concurrent_threads_per_session = 5`, and `agents.max_depth = 1`. Claude Code receives a generated global `CLAUDE.md`, agent Markdown files, skills, and `settings.json` with `auto` permissions, explicit `Agent` permission, and five-operation concurrency. Installation resolves user paths at runtime; the repository contains no machine-specific paths.
|
Codex receives a generated global `AGENTS.md`, agent TOML files, skills, rule files, and a `config.toml` adapter. It keeps workspace sandboxing, automatic approval review, `agents.enabled = true`, `agents.max_concurrent_threads_per_session = 5`, and `agents.max_depth = 1`. Claude Code receives a generated global `CLAUDE.md`, agent Markdown files, skills, and `settings.json` with `auto` permissions, explicit `Agent` permission, and five-operation concurrency. Installation resolves user paths at runtime; the repository contains no machine-specific paths.
|
||||||
|
|
||||||
Both clients embed `shared/rules/general.md` in their global instructions. Codex loads applicable focused rules from `rules/`; Claude generates them as skills from `adapters/claude/rule-skills.tsv`. Angular, WPF, and UI/UX rules have small entry points with references loaded by topic. `security.md` is the baseline for programming tasks; focused security rules cover authentication, web, API, data, files, network, cryptography, and supply-chain work.
|
Both clients embed `shared/rules/general.md` in their global instructions. Codex loads applicable focused rules from `rules/`; Claude generates them as skills from the shared `adapters/rule-skills.tsv` manifest. Angular, WPF, and UI/UX rules have small entry points with references loaded by topic. `security.md` is the baseline for programming tasks; focused security rules cover authentication, web, API, data, files, network, cryptography, and supply-chain work.
|
||||||
|
|
||||||
The Codex adapter sets `agents.max_depth = 1` and does not enable `features.multi_agent_v2`. Shared instructions also prohibit subagents from creating further subagents. Agent roles are optional, not stages that every task must run.
|
The Codex adapter sets `agents.max_depth = 1` and does not enable `features.multi_agent_v2`. Shared instructions also prohibit subagents from creating further subagents. Agent roles are optional, not stages that every task must run.
|
||||||
|
|
||||||
|
|||||||
+1
-1
@@ -15,7 +15,7 @@ The current structure is organized by purpose:
|
|||||||
The files intentionally define only a small baseline. Detailed personal workflows and standards can be added later without changing the structure.
|
The files intentionally define only a small baseline. Detailed personal workflows and standards can be added later without changing the structure.
|
||||||
|
|
||||||
Claude's generated package additionally has `skills/rules/`: one skill per technology- or situation-specific rule in
|
Claude's generated package additionally has `skills/rules/`: one skill per technology- or situation-specific rule in
|
||||||
`shared/rules/` (driven by `adapters/claude/rule-skills.tsv`), so the full rule text loads only when Claude invokes the
|
`shared/rules/` (driven by the shared `adapters/rule-skills.tsv` manifest), so the full rule text loads only when Claude invokes the
|
||||||
matching skill instead of sitting permanently in context. This category does not exist for Codex, which keeps loading
|
matching skill instead of sitting permanently in context. This category does not exist for Codex, which keeps loading
|
||||||
applicable focused rules as plain files instead. Both clients embed the general rules in their global instructions.
|
applicable focused rules as plain files instead. Both clients embed the general rules in their global instructions.
|
||||||
Split Angular, WPF, and UI/UX rules load supporting references only for the topic being worked on. See [Configuration](configuration.md).
|
Split Angular, WPF, and UI/UX rules load supporting references only for the topic being worked on. See [Configuration](configuration.md).
|
||||||
|
|||||||
Reference in new issue
Block a user