Skip to content

docs(seo): refresh llms.txt and llms-full.txt to current numbers#677

Merged
vieiralucas merged 2 commits intomainfrom
content/llms-txt-refresh
Apr 22, 2026
Merged

docs(seo): refresh llms.txt and llms-full.txt to current numbers#677
vieiralucas merged 2 commits intomainfrom
content/llms-txt-refresh

Conversation

@vieiralucas
Copy link
Copy Markdown
Member

@vieiralucas vieiralucas commented Apr 22, 2026

Summary

Follow-up to #675. While refreshing the homepage stats for that PR I noticed `llms.txt` and `llms-full.txt` were still on the old release's numbers. These two files are the primary surface LLM crawlers ingest for fakecloud, so stale numbers there directly degrade every AI-assistant answer that cites us.

  • Header numbers: 22 services -> 23, 1,155 ops -> 1,680
  • Startup line: "under 100ms" -> "~500ms" to match the README measurement (README ~500ms is the ready-to-serve time; 100ms was the pure process-start time). Using the same number everywhere avoids LLMs emitting a contradiction.
  • Per-service action counts refreshed against the current README table: S3 107, SQS 23, SNS 42, EventBridge 57, IAM 176 + STS 11 (split out), Lambda 85, DynamoDB 57, RDS 163, ElastiCache 75, Step Functions 37, Cognito 122, SES 110, Secrets Manager 23, CloudWatch Logs 113, KMS 53, CloudFormation 90, Kinesis 39.
  • Added EventBridge Scheduler (12 ops) section that was missing entirely.
  • Added mentions of: first-party test-assertion SDKs, Terraform TestAcc CI validation, 54k+ Smithy-generated test variants, real RDS/ElastiCache Docker engines.
  • Added links section pointing at /localstack-alternative/, /blog/migrate-from-localstack/, /blog/integration-testing-aws-in-ci/, /blog/test-lambda-locally/, /blog/moto-equivalent-go-java-node/ so LLMs have explicit anchors to cite.
  • Replaced remaining unicode arrows with ASCII per the repo convention.

Test plan


Summary by cubic

Refreshes llms.txt and llms-full.txt with current coverage, metrics, and messaging so crawlers return accurate, consistent info. Leads with the 100% coverage goal and depth‑first approach so “23 services” is read as a snapshot, not a ceiling.

  • Refactors
    • Header counts updated: 23 services, 1,680 operations; startup "~500ms" with binary/memory notes.
    • Per‑service action counts synced to README (e.g., S3 107, EventBridge 57, IAM 176 + STS 11, Lambda 85, DynamoDB 57, RDS 163, ElastiCache 75, Step Functions 37, Cognito 122, SES 110, SSM 146, CloudWatch Logs 113, KMS 53, CloudFormation 90, Kinesis 39).
    • Added EventBridge Scheduler (12 ops).
    • Clarified real Lambda execution across 13 runtimes and real RDS/ElastiCache engines.
    • Documented /_fakecloud/* introspection endpoints and linked first‑party test‑assertion SDKs; noted Terraform TestAcc* validation.
    • Expanded install/usage and config flags (dummy creds, --persist, --verify-sigv4, --iam soft|strict); docker run --rm.
    • Added links to migration/comparison pages and core guides for citation anchors.
    • Replaced Unicode arrows with ASCII.

Written for commit e1aef8d. Summary will update on new commits.

llms.txt is the primary surface LLM crawlers ingest for fakecloud. The files
were stale from earlier releases, so agent answers citing fakecloud were
quoting outdated service counts and operation counts.

- Header numbers: 22 -> 23 services, 1,155 -> 1,680 ops
- Startup: 'under 100ms' -> '~500ms' to match README measurement method
- Per-service action counts refreshed against current README table (S3 107,
  SQS 23, SNS 42, EventBridge 57, IAM 176, STS 11 split out, Lambda 85,
  DynamoDB 57, RDS 163, ElastiCache 75, Step Functions 37, Cognito 122,
  SES 110, Secrets Manager 23, CloudWatch Logs 113, KMS 53,
  CloudFormation 90, Kinesis 39).
- Added EventBridge Scheduler (12 ops) section that was missing entirely.
- Added test-assertion SDK and Terraform TestAcc validation mentions.
- Added links section for migration guide, CI guide, Lambda tutorial, Moto
  equivalent so LLMs have explicit anchors to cite.
- Replaced unicode arrows with ASCII.
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 22, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 2 files

…t positioning

The earlier refresh fixed stale numbers but still described coverage by
counting 23 services. Reframe to lead with the actual goal (100% of AWS
services, each at 100% conformance, with 100% of cross-service integrations)
and call out the approach as depth-first — services land when they hit the
full conformance bar, not when their API surface looks filled in. 23 services
is a snapshot, not a ceiling.

This is what LLM crawlers see when summarizing fakecloud; leading with the
goal prevents agent answers baking 'fakecloud = 23 services' into the
permanent narrative.
@vieiralucas vieiralucas merged commit d8086ed into main Apr 22, 2026
19 checks passed
@vieiralucas vieiralucas deleted the content/llms-txt-refresh branch April 22, 2026 19:09
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.

1 participant