Skip to content

docs(agents): deepinit refresh β€” new docs/AGENTS.md + staleness fixes#76

Merged
pignuante merged 1 commit into
mainfrom
docs/deepinit-refresh
Jul 1, 2026
Merged

docs(agents): deepinit refresh β€” new docs/AGENTS.md + staleness fixes#76
pignuante merged 1 commit into
mainfrom
docs/deepinit-refresh

Conversation

@pignuante

Copy link
Copy Markdown
Contributor

Summary

Hierarchical AGENTS.md refresh (deepinit, update mode): fill the missing docs/ guide and fix staleness surfaced by auditing each AGENTS.md against its directory's current contents. Preserves all <!-- MANUAL --> sections and parent-reference hierarchy.

New

  • docs/AGENTS.md β€” the previously-undocumented GitHub Pages source. Captures the bilingual EN/KO triple-edit rule (data-en/data-ko/visible text), the "N commands" ↔ WindowCommand.menuCommands (34) sync, no-build/publish-lag, the language-toggle script, and funding links.

Staleness fixes (audited vs code)

  • root β€” add docs/ subdir + CLAUDE.md, SECURITY/CONTRIBUTING/SUPPORT/CODE_OF_CONDUCT, RELEASING/LICENSE/NOTICE; add coverage (β‰₯90% gate) + release make targets.
  • Azimuth/Commands β€” add DisplayGeometry.swift, gappedWorkArea/isConstrained; command count 33β†’34.
  • Azimuth/Shared β€” add BundleVersion.swift; note CoordinateSpace.axWorkArea(of:).
  • scripts β€” add coverage.sh, release.sh, make-dmg-background.swift, and the dmg/ subdir.
  • .github β€” add FUNDING.yml, CODEOWNERS, PULL_REQUEST_TEMPLATE.md.
  • Azimuth β€” add AboutWindowController.swift.
  • Commands / Hotkeys / StatusBar / Tests β€” fix stale command count 33β†’34; refresh Tests coverage description; bump timestamps.

Validation

  • All 15 AGENTS.md parent references resolve; new docs/AGENTS.md β†’ ../AGENTS.md OK.
  • No stale "33" command-count strings remain repo-wide; "34" matches menuCommands (verified by listing the array = 34 entries).
  • pre-commit hooks pass (gitleaks / SwiftFormat / SwiftLint 0).

- NEW docs/AGENTS.md: GitHub Pages source; bilingual EN/KO triple-edit rule,
  command-count sync, no-build/publish-lag, funding links.
- root AGENTS.md: add docs/ subdir + CLAUDE.md, community health files,
  RELEASING/LICENSE/NOTICE; add coverage/release make targets.
- Commands: add DisplayGeometry.swift + gap-maximize/isConstrained; 33β†’34.
- Shared: add BundleVersion.swift; note CoordinateSpace.axWorkArea(of:).
- scripts: add coverage.sh/release.sh/make-dmg-background.swift + dmg/ subdir.
- .github: add FUNDING.yml/CODEOWNERS/PULL_REQUEST_TEMPLATE.md.
- Azimuth: add AboutWindowController.swift.
- Fix stale command count 33β†’34 in Commands/Hotkeys/StatusBar/Tests; bump timestamps.
@pignuante pignuante self-assigned this Jul 1, 2026
@pignuante pignuante merged commit 5dfe0e9 into main Jul 1, 2026
3 checks passed
@pignuante pignuante deleted the docs/deepinit-refresh branch July 1, 2026 08:58
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