Skip to content

[codex] Consolidate specs under spec directory#166

Merged
sungjunlee merged 2 commits into
mainfrom
codex/spec-layout
May 29, 2026
Merged

[codex] Consolidate specs under spec directory#166
sungjunlee merged 2 commits into
mainfrom
codex/spec-layout

Conversation

@sungjunlee
Copy link
Copy Markdown
Owner

Summary

  • Move the canonical charter artifact to spec/charter.md with root CHARTER.md retained only as a legacy fallback.
  • Add spec/README.md, dogfood spec/system-map.md, and a new spec-system-map skill/template.
  • Wire charter path resolution through objectives checks, spec-grill signal extraction, backlog-triage alignment guidance, and active docs.

Validation

  • node --test over all non-integration JS tests: 409 passed
  • node skills/spec-charter/scripts/check-size.js --path spec/charter.md --json
  • node skills/dev-backlog/scripts/objectives-check.js --json
  • node skills/dev-backlog/scripts/capabilities-doctor.js --json
  • node skills/dev-backlog/scripts/component-lint.js --json
  • node skills/spec-grill/scripts/extract-signals.js --repo-root . --json
  • git diff --check

Closes #161
Closes #162
Closes #163
Closes #164
Closes #165

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 29, 2026

Warning

Review limit reached

@sungjunlee, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 20 minutes and 1 second. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b7137452-18f4-4972-b36d-fd7a94838675

📥 Commits

Reviewing files that changed from the base of the PR and between 19401fc and 36d8419.

📒 Files selected for processing (30)
  • AGENTS.md
  • CHANGELOG.md
  • CLAUDE.md
  • README.md
  • docs/spec-system-design.md
  • skills/backlog-triage/SKILL.md
  • skills/dev-backlog/SKILL.md
  • skills/dev-backlog/references/process.md
  • skills/dev-backlog/scripts/objectives-check.js
  • skills/dev-backlog/scripts/objectives-check.test.js
  • skills/dev-backlog/scripts/spec-paths.js
  • skills/spec-charter/SKILL.md
  • skills/spec-charter/references/alignment.md
  • skills/spec-charter/references/amendment.md
  • skills/spec-charter/references/create.md
  • skills/spec-charter/references/objectives.md
  • skills/spec-charter/references/reassess.md
  • skills/spec-charter/scripts/check-size.js
  • skills/spec-charter/scripts/check-size.test.js
  • skills/spec-grill/SKILL.md
  • skills/spec-grill/references/capabilities.md
  • skills/spec-grill/scripts/extract-signals.js
  • skills/spec-grill/scripts/extract-signals.test.js
  • skills/spec-grill/templates/capabilities.md
  • skills/spec-system-map/SKILL.md
  • skills/spec-system-map/templates/system-map.md
  • spec/README.md
  • spec/capabilities.md
  • spec/charter.md
  • spec/system-map.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/spec-layout

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@sungjunlee sungjunlee marked this pull request as ready for review May 29, 2026 13:01
@sungjunlee sungjunlee merged commit 4c1683d into main May 29, 2026
2 checks passed
@sungjunlee sungjunlee deleted the codex/spec-layout branch May 29, 2026 13:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant