Skip to content

docs: consolidated documentation PRs (#34–#37) — validated & corrected - #38

Merged
PhysShell merged 12 commits into
mainfrom
claude/pr-docs-review-validation-1wat02
Jul 8, 2026
Merged

PhysShell merged 12 commits into
mainfrom
claude/pr-docs-review-validation-1wat02

Conversation

@PhysShell

Copy link
Copy Markdown
Owner

Summary

Консолидирует все 4 открытых документационных PR (#34, #35, #36, #37) в один, с валидацией и корректировками:

  • docs/agent-run-triage.md (из Document agent-run triage as the evidence-sink phase of 007's Zero Trust roadmap #34) — уточнена привязка полей идентичности run'а к Phase 1: сегодняшний RunMeta в 007 (src/record.rs) не содержит agent_id/policy_id; live-URL заменены на plain-path кросс-ссылки; audit/security/ помечен как «предложено в P-024, не построено».
  • docs/agentic-coding-discipline-proposal.md (из docs: add agentic coding discipline proposal #35) — заменён указателем на канонический документ в Own.NET: идентичные копии в трёх репо неизбежно разъезжаются.
  • docs/architecture-review.md (из Create architecture-review.md #36) — чат-вставка нормализована: пример отчёта взят в fence (его сырой # Architecture Review рендерился как второй H1 документа), секции стали заголовками, все CLI/JSON-примеры в код-блоках, ссылки на живые PR заменены файловыми, артефакты-входы оформлены подзаголовками с указателем на Own.NET P-032 (Own.Arch).
  • docs/sketch-based-evidence.md (из Create sketch-based-evidense.md #37) — исправлена опечатка в имени файла (evidense → evidence), нормализована структура, добавлены перекрёстные ссылки на парные sketch-документы (007 sketch-aware-evidence.md, Own.NET P-033) и разграничение SimHash-скоупа с 007.
  • README: три новых дизайн-дока добавлены в таблицу «where things live».

Парные консолидированные PR: Own.NET #190 и 007 (та же ветка claude/pr-docs-review-validation-1wat02). Старые PR #34–#37 закрываются с указателем сюда.

Test plan

  • Docs-only; механический верификатор по изменённым файлам: ссылки резолвятся, код-фенсы сбалансированы, конфликт-маркеров нет.
  • Содержательная валидация против кода (multi-agent review) — фактические утверждения сверены с 007/src/*.rs, Run-Audit.ps1, report/diff_cli.py.

🤖 Generated with Claude Code

https://claude.ai/code/session_016tY7jvPGyDWmWYjrRHWPnM


Generated by Claude Code

claude and others added 12 commits July 5, 2026 07:12
…ust roadmap

Adds docs/agent-run-triage.md: reuses the existing confirmed/static-only/
runtime-only triage pattern (runtime-contract.md) and rule-to-verdict
methodology (audit-data-leverage.md) for a new evidence source — 007's
structured per-run audit trail — instead of building a separate pipeline.
Scopes it explicitly as ingest-and-report only: enforcement stays with
007+Sandboy, disposition stays human, per the same orchestrator-not-analyzer
charter already codified for the security profile (P-024 in Own.NET).
…un triage

Ingest adapter's first move should be verifying 007's run-record hash chain
before trusting any of it, same reflex already applied to runtime.json inputs.
Names concrete instances of the policy-violation-confirmed bucket so the
triage buckets aren't purely abstract, and flags an agent editing its own
gate config as always requiring human review, even when the step itself passed.
…b0vgrw' into claude/pr-docs-review-validation-1wat02
…-oe7qd7' into claude/pr-docs-review-validation-1wat02
- rename docs/sketch-based-evidense.md -> docs/sketch-based-evidence.md (typo)
- replace chat-paste preambles (Target repository / Suggested file) in
  architecture-review.md and sketch-based-evidence.md with standard headers
- index the three new design docs in README's 'where things live' table
- agent-run-triage: scope the Phase-1 qualifier over the meta.json identity
  fields (RunMeta today has no agent_id/policy_id — src/record.rs); replace
  live blob URLs with plain cross-repo paths; qualify the audit/security/
  layout as proposed-in-P-024, not built
- architecture-review: fence the example report (its raw '# Architecture
  Review' rendered as a mid-document H1), promote pasted section titles to
  headings, fence all CLI/JSON/tree examples, replace live-PR references with
  in-repo links, artifact names as subheadings with a pointer to Own.NET
  P-032 (Own.Arch)
- sketch-based-evidence: promote section titles to headings, fence all
  examples, add Related links to the sibling sketch docs (007
  sketch-aware-evidence, Own.NET P-033), scope SimHash grouping vs 007's
  per-run fingerprints
@coderabbitai

coderabbitai Bot commented Jul 8, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@PhysShell, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 59 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

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.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a69c7697-7b1c-421e-a2ce-c8752fa8f13c

📥 Commits

Reviewing files that changed from the base of the PR and between 540aa06 and 63c621b.

📒 Files selected for processing (5)
  • README.md
  • docs/agent-run-triage.md
  • docs/agentic-coding-discipline-proposal.md
  • docs/architecture-review.md
  • docs/sketch-based-evidence.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/pr-docs-review-validation-1wat02

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.

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.

2 participants