Skip to content

docs(agents): add CWL-ENTRY read-first block - #1528

Draft
seonghobae wants to merge 2 commits into
developfrom
docs/agents-add-cwl-entry-block
Draft

docs(agents): add CWL-ENTRY read-first block#1528
seonghobae wants to merge 2 commits into
developfrom
docs/agents-add-cwl-entry-block

Conversation

@seonghobae

@seonghobae seonghobae commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a readable <!-- CWL-ENTRY --> read-first block to AGENTS.md using Naruon's canonical product specification, live Project, gap baseline, completion issue, and current Proposed Figma decision.
  • Keeps organization-wide operating guidance linked to ContextualWisdomLab/.github instead of duplicating its protocol or autonomous-loop directive.
  • Adds a governance regression test so these entry points cannot silently drift into private agent memory or stale repository references.

Exact revision

  • Head: 57254cb61ecc67dd593ea96ae878bf651682a501
  • Base: develop
  • State: Draft while fresh exact-head hosted checks and review evidence run.

Verification

.github's AGENTS.md carries a <!-- CWL-ENTRY --> block pointing agents at
the master context, live GitHub Project, and gap snapshot before any work.
naruon never had this block (it only has a naruon-specific
cwl-agent-guidance section below it), so agents landing here had no
equivalent pointer. Add naruon's own version, wired to naruon's real docs:
docs/architecture/naruon-product-spec.md for mission/architecture, the
existing docs/product-technical-gap-baseline.md gap snapshot, and a
cross-repo link to .github's agent-github-project-protocol.md and
product-goal-directive.md, which are genuinely org-wide and not duplicated
per repo. The Figma file ID line reflects naruon's actual current state
(not yet canonical on develop; ADR-0013 is still in open PR #1436) rather
than the N/A placeholder that would make no sense for a repo that has UI.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

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.

@devin-ai-integration devin-ai-integration 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.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Devin Review

@seonghobae seonghobae added documentation Improvements or additions to documentation priority: medium Normal-priority or P2 work status: needs-review Open pull request requiring current-head review or checks type: docs Documentation, ADR, PRD, or technical writing labels Sep 2, 2026 — with ChatGPT Codex Connector
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

PR governance metadata gate is not ready for cf472cf77fb93325858f485a22e967449d7c387a:

  • Required check strix is CANCELLED on the current head.

seonghobae added a commit to ContextualWisdomLab/.github that referenced this pull request Sep 3, 2026
…dict contradiction

- Cite ContextualWisdomLab/naruon#1528 with owner prefix in both remaining
  spots (Devin Review: cross-repo reference format violation)
- Fix the self-contradiction Devin caught: "Result 1 verified all four
  central workflows' cancellation logic is correct" directly contradicted
  the same document's confirmed noema-review.yml bug finding above it.
  Corrected to: three of four are fully correct; the fourth's confirmed
  bug has a different failure signature (wrongful cancellation of a live
  run) than what Result 2's evidence shows (runs stuck queued for
  23h22m/24+ hours with no cancellation at all) -- so the bug still
  doesn't explain this specific wait, without overstating the workflows'
  correctness.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Format the CWL entry as a readable source checklist and add a governance regression for the product spec, Project, gap baseline, completion issue, Figma proposal, and central operating documents.\n\nAssisted-by: OpenAI Codex <codex@openai.com>
@seonghobae
seonghobae marked this pull request as draft September 4, 2026 20:51
seonghobae added a commit that referenced this pull request Sep 4, 2026
Record exact heads and verified successor boundaries for PRs #1528, #1549, #1566, and #1567.\n\nAssisted-by: OpenAI Codex <codex@openai.com>
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 priority: medium Normal-priority or P2 work status: needs-review Open pull request requiring current-head review or checks type: docs Documentation, ADR, PRD, or technical writing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant