Scout

AGENTS.md

Scout - Wiki Schema

Type: project Created: 2026-05-14

Entry Point

Read index.md first. It maps all files and tracks recent activity.

File Roles

  • index.md: Navigation catalog. Keep current after every meaningful wiki update.
  • log.md: Append-only operation chronicle.
  • raw/: Immutable source documents and assets.
  • wiki/overview.md: Product thesis, personas, architecture overview.
  • wiki/requirements.md: Functional requirements and acceptance criteria.
  • wiki/decisions/: ADRs. One file per decision.
  • wiki/dev-log.md: Append-only build and discovery log.
  • wiki/open-questions.md: Living checklist of unresolved decisions.
  • wiki/use-cases/: Use-case catalog, test scenarios, example sites.
  • wiki/sources/: Source and example URL notes.
  • wiki/concepts/: Domain concepts.
  • wiki/entities/: People, companies, tools, providers.
  • wiki/syntheses/: Cross-cutting analysis and strategy.

Iron Rules

  • Update index.md after every material operation.
  • Append to log.md; do not delete prior entries.
  • Write major architecture decisions as ADRs under wiki/decisions/.
  • Every use case should define test scenarios, expected records, example websites, provider needs, and known risks.
  • Every data point that matters should include source provenance.
  • Do not treat Crawl4AI as the whole product. It is one provider inside Scout.