docs(observability): save plan log + architectural refinement + future work#204
Open
vibe-dex wants to merge 1 commit into
Open
docs(observability): save plan log + architectural refinement + future work#204vibe-dex wants to merge 1 commit into
vibe-dex wants to merge 1 commit into
Conversation
…e work Consolidates the observability working log into a single in-repo doc: - First/Second/Third Context (pre-existing) — original brief, framework plan that became PR 179, apps repo plan. - Fourth Context — May 22 architectural refinement (PRs A/B/C/D across stats-lake and deco-start) with the 4-PR split table, D-records D-9 through D-17 summarized (full text lives in MIGRATION_TOOLING_PLAN.md), and the Phase 4 JSON-body lift bug post-mortem. - Fifth Context — Deploy + validate state on lebiscuit-tanstack (PR #52 open, CF preview green, validation queries documented for the post-merge pass). - Sixth Context — P1 through P7 future work, each carrying Shippable-Now vs Architecturally-Refined lenses where there's a real tradeoff, plus Evolution Paths. - Source-of-truth links at the bottom point at runbooks, audit script, RUM plan, collector target, dashboard templates. Companion to the canonical user-facing reference at docs/observability.md. This file is the working/decision log; docs/observability.md is the API and query reference. No code, no surface change. semantic-release no-ops on docs: commits. Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Saves the observability working log + the May 22 architectural refinement plan + the future-work roadmap into
docs/o11y.md, so the chain of decisions survives outside chat history.Four new sections appended (existing sections untouched):
MIGRATION_TOOLING_PLAN.mdfor full text, and the Phase 4 JSON-body lift bug post-mortem.lebiscuit-tanstack(deco-sites/lebiscuit-tanstack#52) — what's deployed, what's pending, six validation queries to run after merge.This file (
docs/o11y.md) is the decision/working log. The canonical user-facing reference isdocs/observability.md. Splitting roles deliberately — when the lebiscuit validation lands green, the verified results graduate intodocs/observability.mdand this log keeps being the audit trail.Reviewer notes
/Users/fernandofrizzatti/...paths from earlier chat-captured plans. They're useful breadcrumbs but identity-leaky. My additions only added one~/.cursor/plans/...(tilde'd, so less of an issue). If you want them scrubbed pre-merge, ping me and I'll push a follow-up commit; otherwise I'm accepting them as the cost of preserving the original log verbatim.docs:commit, no surface change. semantic-release no-ops; no version bump, no publish. CI should be green on lint/format only.docs/observability.md(the public reference) is unchanged.Release channel
mainis correct per.cursor/rules/release-workflow.mdc— docs change, no shipped behavior, semantic-release will no-op.Made with Cursor
Summary by cubic
Adds
docs/o11y.mdas the observability working/decision log, capturing the May 22 architectural refinement (4-PR split), lebiscuit deployment validation steps, future work, and source-of-truth links. No code or user-facing docs changed;docs/observability.mdremains the canonical reference.Written for commit cf95518. Summary will update on new commits.
Review in cubic