Skip to content

Slim Wurst project agent template - #77

Open
Frotty wants to merge 2 commits into
masterfrom
codex/slim-wurst-agent-template
Open

Slim Wurst project agent template#77
Frotty wants to merge 2 commits into
masterfrom
codex/slim-wurst-agent-template

Conversation

@Frotty

@Frotty Frotty commented Aug 8, 2026

Copy link
Copy Markdown
Member

Summary

  • reduce the generated Wurst project AGENTS.md from 251 lines / roughly 2,100 words to 73 lines / 788 words
  • retain project invariants, stdlib-first guidance, high-risk Wurst semantics, object-generation safety, and validation commands
  • route detailed language and dependency guidance on demand, preferring compiler-matched local docs with the official manual as fallback
  • correct scriptMode and wc3Patch guidance and synchronize the template version
  • add regression tests for the documentation routing contract and template size budget

Why

The generated preset is loaded into every agent session. It had accumulated language reference material, dependency-owned UI rules, and repeated pitfalls, making important project policy harder to find while still omitting authoritative build-target guidance.

This keeps the always-loaded working set compact and moves detailed knowledge behind explicit, task-specific routes.

Impact

Newly generated Wurst projects receive a smaller, more focused preset. Current compiler releases do not yet ship WURST_LANGUAGE.md, so the official online manual remains an explicit fallback until compiler-owned agent docs are available.

Validation

  • ./gradlew test --tests AgentsTemplateTests --tests GenerateTests.testAgentsTemplateMarkerAndWarnings
  • ./gradlew test
  • git diff --check

@Frotty
Frotty marked this pull request as ready for review August 8, 2026 11:50

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6830a63baa

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/main/kotlin/file/SetupApp.kt
@Frotty

Frotty commented Aug 8, 2026

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c262807f08

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

private fun ensureCompilerAgentDocs(compilerJar: Path) {
try {
JarFile(compilerJar.toFile()).use { jar ->
val entry = jar.getJarEntry(LANGUAGE_AGENT_DOC_ENTRY) ?: return

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove stale language docs when the compiler omits them

When a compiler that contains agent-docs/WURST_LANGUAGE.md is replaced or downgraded to a compiler without that entry, this early return leaves the previously extracted file in place. Generated project notes then find the local file and treat it as compiler-matched instead of using the online fallback, potentially giving agents semantics from the wrong compiler version; delete the extracted file when the active JAR lacks the entry.

AGENTS.md reference: AGENTS.md:L18-L18

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant