Skip to content

[P3] Docs drift in README and AGENTS.md #94

Description

@Bccorb

Severity: P3 — Docs

Where: README.md, AGENTS.md

Problem

  • README shows the removed bootstrap-admin --profile flag and wrong instance resolution (README.md:163-181); --profile is now ignored (resolution is --api-urlSEAMLESS_API_URLhttp://localhost:3000).
  • README says "Node.js 18 or newer" but engines is >=24 <25 and .nvmrc is 24 (README.md:370).
  • README/AGENTS list a dead top-level templates/ dir (templates moved to the seamless-templates monorepo); package.json files also ships it.
  • verify --filter <flow> (space form) is advertised in AGENTS but only --filter=<flow> parses (src/commands/verify.ts:33).
  • AGENTS.md prescribes npm run typecheck/lint/format:check that don't exist, plus a stale commands list.

Suggested fix
Reconcile docs with actual behavior; either add the missing lint/typecheck/format scripts or drop them from AGENTS.

Filed from an internal code audit (2026-07). File references are against main at audit time.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:cliSeamless CLIdocumentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions