Skip to content

meta: track concise agent guidance - #67

Merged
goroyabu merged 1 commit into
mainfrom
docs/issue-21-agent-guidance
Sep 17, 2026
Merged

goroyabu merged 1 commit into
mainfrom
docs/issue-21-agent-guidance

Conversation

@goroyabu

Copy link
Copy Markdown
Owner

Summary

  • track a concise root AGENTS.md that defines stable f2c repository boundaries
  • direct agents to the canonical README, contribution, test, and security guidance instead of duplicating detailed procedures
  • remove the root AGENTS.md ignore rule while retaining ignored local documentation notes

Machine-specific interaction rules were moved to the existing global Codex guidance and are intentionally not part of this repository. The superseded ignored documentation-design note was reviewed and removed locally; it is not part of the Git diff.

Related Issue

Closes #21

Verification

  • git diff --cached --check completed without errors before the commit
  • confirmed every canonical file and template referenced by AGENTS.md exists
  • confirmed the global Codex guidance contains the machine-level workflow section exactly once
  • confirmed the superseded local documentation-design note was removed
  • started a fresh subagent without conversation history and confirmed that it distinguished the global guidance from the f2c-specific guidance, summarized both, and identified the canonical repository documents
  • build and CTest were not run because the tracked change affects agent documentation and ignore behavior only

Impact

Fresh clones now receive concise repository-specific agent guidance. Build, runtime, installation, package, CI, and release behavior are unchanged.

Documentation

Adds the repository-owned AGENTS.md. Existing canonical documents remain unchanged.

Checklist

  • The change is focused on one coherent maintenance outcome.
  • Relevant verification has been run and reported above.
  • Canonical guidance remains self-contained and is not duplicated.
  • No downloaded archives, generated files, build outputs, or local configuration were committed.

- Point agents to canonical repository documentation
- Preserve stable f2c scope, artifact, and verification boundaries
- Retire the ignore rule for the repository-owned AGENTS.md
@goroyabu goroyabu added the documentation Improvements or additions to documentation label Sep 17, 2026
@goroyabu
goroyabu merged commit f8c7dd1 into main Sep 17, 2026
6 checks passed
@goroyabu
goroyabu deleted the docs/issue-21-agent-guidance branch September 17, 2026 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

meta: decide whether to track repository agent guidance

1 participant