Skip to content

docs: rewrite AGENTS.md, README and MOBILE-API in STE-100 and fix stale facts #59 - #60

Merged
yashiels merged 1 commit into
mainfrom
agent/docs-ste
Sep 27, 2026
Merged

yashiels merged 1 commit into
mainfrom
agent/docs-ste

Conversation

@yashiels

Copy link
Copy Markdown
Owner

ASD-STE100 rewrite (STE-flavored mode) of AGENTS.md (CLAUDE.md is a symlink to it), README.md and docs/MOBILE-API.md. Hard lint violations 8 / 8 / 21 -> 0 / 0 / 0.

Fact fixes, each checked against the 0.7.2 code:

  • __cf_bm IS stored in pending-otp-.json (0600) between login and the OTP submit. The CLI removes the file on success, expiry or state mismatch (AGENTS.md says __cf_bm is never persisted; the two-step OTP flow writes it to the pending-challenge file #57).
  • AGENTS.md structure tree: wishlist.ts, skill/, endpoints-catalogue.json, docs/plans. CI/release section describes the binary smoke gate and the manual ship workflow.
  • New AGENTS.md rules: no code comments, no whole-file prettier, live tests are read-only.
  • README: wishlist commands, cart guard, full error envelope, unavailable_state, address use --file (the old address use A123 example was wrong).
  • MOBILE-API: auth headers and cookies documented as conditional (matches authHeaders/cookieHeader). All 16 code blocks byte-identical.

Left as written: CHANGELOG.md (release history) and docs/plans/no-payments.md (the signed-off design record).

Oracle meaning-drift review: signed off (3 rounds; fixed a weakened live-test rule, an overstated PR claim, and unconditional header claims). make ci: 397 pass.

Closes #59
Closes #57

@sentinel-skyner sentinel-skyner 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.

🛡️ Sentinel review

No material issues found in this diff.

Automated review via cursorbridge:gpt-5.3-codex. Findings only — not an approval. Push new commits to re-review.

@yashiels
yashiels merged commit 4a48eea into main Sep 27, 2026
1 check passed
@yashiels
yashiels deleted the agent/docs-ste branch September 27, 2026 00:42
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