Skip to content

Commit 6bcd1a2

Browse files
committed
Correct template path and require copy-first template preservation for new first-class tool creation - PR_26146_014-template-path-and-new-tool-copy-rules
1 parent 9e80ec3 commit 6bcd1a2

1 file changed

Lines changed: 24 additions & 1 deletion

File tree

docs/dev/PROJECT_INSTRUCTIONS.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1096,11 +1096,34 @@ New first-class tools must include Playwright launch coverage.
10961096

10971097
Tool registration must not rely on hidden defaults or silent fallback.
10981098

1099+
When creating a new first-class tool, Codex must copy the official template from `tools/_templates-v2/` first.
1100+
1101+
The copied template must retain the template-provided:
1102+
- header structure
1103+
- NAV structure
1104+
- panel layout
1105+
- accordion structure
1106+
- CSS wiring
1107+
- JavaScript module wiring
1108+
- status/logging areas
1109+
- accessibility hooks
1110+
- external script/css separation
1111+
1112+
Add tool-specific code only after the copied template structure is preserved.
1113+
1114+
Do not recreate the tool shell from scratch.
1115+
1116+
Do not remove template sections unless the PR explicitly authorizes it.
1117+
1118+
Keep HTML free of inline script/style/event handlers.
1119+
1120+
Register the new tool only after the copied template is adapted.
1121+
10991122
## TOOL TEMPLATE V2 LOCATION
11001123

11011124
The official First-Class Tool V2 starter is:
11021125

1103-
`tools/templates-v2/`
1126+
`tools/_templates-v2/`
11041127

11051128
Use the V2 naming consistently:
11061129
- Tool Template V2

0 commit comments

Comments
 (0)