Skip to content

chore: restore AGENTS root and test log - #10

Merged
Alek2077 merged 1 commit into
mainfrom
chore/restore-repo-root-agents-symlink
Mar 20, 2026
Merged

Alek2077 merged 1 commit into
mainfrom
chore/restore-repo-root-agents-symlink

Conversation

@Alek2077

Copy link
Copy Markdown
Contributor

Related Issue

N/A

Description

Restores a repository-root AGENTS.md symlink so Codex CLI can discover the shared instructions within the .github project scope.

Changes Made

  • Added a repository-root AGENTS.md symlink in .github.
  • Pointed the symlink to the canonical AGENTS.md file in aicgs.

Testing Performed

  • Manual review of the symlink target path.
  • Manual review of repository status to confirm the change scope is limited to AGENTS.md.

Add a repository-root AGENTS.md symlink for Codex CLI discovery.
Point the symlink to the canonical AGENTS.md file in aicgs.
@Alek2077 Alek2077 added type: chore A task with no direct user value (e.g., updating dependencies) priority: P3-low Cosmetic fix, nice-to-have status: needs-review For Pull Requests area: repository Repository config, CI/CD, and project management labels Mar 20, 2026
@Alek2077 Alek2077 self-assigned this Mar 20, 2026
@Alek2077
Alek2077 merged commit 63b1487 into main Mar 20, 2026
@Alek2077
Alek2077 deleted the chore/restore-repo-root-agents-symlink branch March 20, 2026 10:40
@github-actions github-actions Bot added status: done and removed status: needs-review For Pull Requests labels Mar 20, 2026
@Alek2077

Copy link
Copy Markdown
Contributor Author

Post-merge rationale note for the AGENTS.md portion of this change:

This layout was chosen after checking the current OpenAI Codex documentation and then verifying behavior locally. The relevant docs indicate that project-scoped AGENTS.md discovery is bounded by the project root (typically the git root), rather than arbitrary parent directories above it.

We tested the centralized parent-level setup directly and Codex still reported Agents.md: <none> in fresh repo sessions. Based on that evidence, the repo-root AGENTS.md layout was restored for reliable Codex CLI discovery, while keeping a single source of truth by pointing sibling repo-root entries at the canonical file.

@Alek2077

Copy link
Copy Markdown
Contributor Author

Additional concrete findings from the same investigation:

  • Keeping the only AGENTS file in ~/.codex/AGENTS.md was not reliable for repo-scoped Codex CLI discovery in this setup.
  • Moving the file up to /home/atompowered/python_projects/AGENTS.md also did not work; fresh Codex sessions in repo directories still showed Agents.md: <none>.
  • That is why the final layout was changed to repo-root AGENTS.md entries, with symlinks used to preserve one shared source of truth.

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

Labels

area: repository Repository config, CI/CD, and project management priority: P3-low Cosmetic fix, nice-to-have status: done type: chore A task with no direct user value (e.g., updating dependencies)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant