Skip to content

Audit factory positioning and align writing guidance with infrastructure framing #1010

New issue
New issue
Open
Open
Audit factory positioning and align writing guidance with infrastructure framing#1010
Labels
factory:docs-factoryLabel associated to the "docs-factory" factoryimprove or update documentationIncorrect, outdated, missing, or unclear documentation contentpriority/mediumOutdated content, confusing instructions, incomplete coveragetriageNeeds human review — remove after triaging

Description

@warp-agent-staging
warp-agent-staging
bot
opened on Nov 10, 2026

Description

Audit public docs against Zach Lloyd’s supplied Warp Positioning PDF and report each mismatch with its location, source principle, and narrow recommendation.
Update the shared writing guidance so future docs frame Warp Factories as open, flexible infrastructure on which teams build their own software factories, not a product or team of agents.
Preserve the distinction between the infrastructure platform, customer-defined workflows, and an opinionated quickstart.
This request authorizes findings and writing-guidance updates, not a blanket rewrite of published docs or invocation of Self-improvement.

Evidence

The source explicitly says not to describe Warp Factories as a “product” or “team of agents.”
Current authoring guidance calls it a product, while the overview and lifecycle page lead with “A factory is a team of cloud agents”; audit the latter in context to distinguish the platform from a customer’s configured workflow.
No runtime reproduction is needed: the contradiction is present in the source text.

Acceptance criteria

  • Account for all 418 Markdown/MDX pages in the checked-out public corpus, including factory references outside factories/; record the revision and any exclusions, and inspect shared rendering/name surfaces where relevant.
  • Report actionable mismatches with exact page/section references, the governing PDF principle, and a suggested narrow correction; distinguish confirmed conflicts from editorial opportunities and aligned material.
  • Reconcile canonical positioning, glossary, author, and reviewer entry points so they consistently require the supplied positioning without mandatory slogans or duplicate policy copies.
  • Keep positioning separate from shipped-behavior evidence: do not introduce universal model/harness support, ROI guarantees, competitor claims, or new availability promises from the strategy document.
  • Record relevant overlapping PRs and validation results for guidance changes; keep published-page rewrites as recommendations unless separately authorized.

Proposed solution direction

Suggest reconciling the existing canonical positioning file and glossary first, then routing author and reviewer skills through that single source.
Use whole-corpus reading with keyword discovery as an aid, not as a substitute for semantic coverage.
Preserve accurate procedures, interface names, and descriptions of actual agent collaboration.

References

  • Requester: Zach Lloyd (verified GitHub: @zachlloyd); original request: https://warpdev.slack.com/archives/C09BVK0PL3Y/p1794326688291009
  • Supplied source: https://warpdev.slack.com/files/U0C1BTFJ9SN/F0CG29RL9V5/612e2bf4-5baf-47eb-b0f0-f5fa93a5098d_warp_positioning.pdf ; original Notion provenance: https://app.notion.com/p/warpdev/Warp-Positioning-3c743263616d81139c2fdd1cd4d1b331 . PDF was supplied in-thread after Notion returned 404; source identifies itself as the current working direction from Growth Team Strategy Aug 2026.
  • Docs revision: a571309; config revision: f0ace6bdcc1ce6c8c6b5041ddc8710e1bd5d651b.
  • Confirmed guidance conflict: AGENTS.md:953; .agents/references/terminology.md:331-357 (“product” / “product implementation”). Existing canonical framing: .agents/rules/oz-style-guidelines.md:3-9.
  • Public framing to examine: src/content/docs/factories/index.mdx:3-13; src/content/docs/factories/how-factories-work.mdx:10; src/content/docs/platform/transitioning-from-oz.mdx:11 (“web experience”). These are seed findings, not a completed full-corpus audit.
  • Enforcement paths: .agents/skills/draft_docs/SKILL.md:66; .agents/skills/review-docs-pr/SKILL.md:107; all eight type-specific draft skills route through draft_docs and AGENTS.md. Config: skills/docs-quality/SKILL.md, stages/implementation.md, stages/review.md. Existing policy-routing tests: .agents/skills/doc_quality_policy/test_editorial_guidance.py:42,78-79.
  • Inventory method: Python pathlib recursive enumeration of all .md / .mdx beneath src/content/docs, case-insensitive whole-word factory|factories discovery. 418 pages total; 178 matching pages; 4,484 raw occurrences including links and code. Matching-page distribution: factories 101; platform 31; agents 24; guides 9; enterprise 7; support-and-community 3; getting-started 1; changelog 1; root landing 1. Keyword matches are not confirmed positioning defects; variable-backed product names require additional coverage.
  • Existing related work: docs: clarify the Factories overview definition #884 (open overview definition); docs: test ROI framing for factory metrics (AR-17) #890 (open ROI framing); docs: reconcile drafting guidance and protect reader understanding #881 (merged canonical guidance); docs: editorial review of product overviews, factories, and quickstarts #910 (merged editorial pass). No clearly matching issue found in both repositories’ positioning searches or complete current open-item listings.
  • Triage: complexity M for remaining bounded audit/report and shared-guidance update; ambiguity none. No unresolved requester question after source delivery. No public content edits or live UI reproduction performed during triage.

Activity

  1. warp-agent-staging
    added
    priority/mediumOutdated content, confusing instructions, incomplete coverage
    triageNeeds human review — remove after triaging
    improve or update documentationIncorrect, outdated, missing, or unclear documentation content
    factory:docs-factoryLabel associated to the "docs-factory" factory
    on Nov 10, 2026

  2. warp-agent-staging commented on Nov 10, 2026

    @warp-agent-staging
    warp-agent-stagingBot
    on Nov 10, 2026 – with Warp Agent Staging
    ContributorAuthor

    Completed positioning audit: findings and recommendations

    Audit revision: a571309952bb011f2f5d09a6b2dcab34e6abaa35; factory config f0ace6bdcc1ce6c8c6b5041ddc8710e1bd5d651b. Recommendations only: published pages were not rewritten. The supplied PDF establishes framing, not release, compatibility, privacy, or ROI facts.

    Confirmed positioning conflicts

    P1: factories/index.mdx:4 — Frontmatter description.

    Warp Factories turns issues, tickets, and Slack messages into reviewed pull requests. Teams of cloud agents do the work, while people approve specs and merges.

    Principle: PDF pp.1–2: platform identity is infrastructure customers build on, not a team of agents.
    Recommendation: Lead the standalone description with the infrastructure identity and customer ownership, then give the default intake-to-review loop as an example. Coordinate opener wording with open PR #884; preserve its lifecycle, customization, and evaluation detail.

    P2: platform/transitioning-from-oz.mdx:11 — Opening.

    Warp Factories is the web experience for team development workflows organized around repositories, agents, and automations.

    Principle: PDF pp.1–2: infrastructure platform, not one product surface.
    Recommendation: Define the infrastructure platform first and identify the web app as a management surface. Preserve the transition purpose, current standalone interfaces, command distinctions, and workflow-assessment caveats; no automatic migration claim.

    P3: enterprise/index.mdx:15 — Opening.

    Warp's product for building and operating software factories, where cloud agents triage, spec, implement, review, and verify work, and humans approve key decisions.

    Principle: PDF p.2: infrastructure platform rather than product; defaults do not define every customer workflow.
    Recommendation: Replace the product definition with infrastructure for building and operating customer-defined software factories. Keep the listed lifecycle as one workflow, not the only supported factory. Adjust the immediate three-products introduction only as needed to avoid reintroducing the same categorization.

    P4: guides/agent-workflows/set-up-a-software-factory.mdx:14 — Opening.

    To run this same loop as a managed product instead of wiring it yourself, see Warp Factories.

    Principle: PDF pp.1–2: infrastructure, with opinionated quickstart rather than a prescribed product workflow.
    Recommendation: Keep the DIY GitHub Actions procedure. Describe the alternative as building this workflow on Warp infrastructure, not a managed product; narrowly correct the same product framing in Next steps at line 165. Do not imply the default agents must reproduce exactly four DIY roles.

    Same framing at guides/agent-workflows/set-up-a-software-factory.mdx:165: “Warp's product for running this same intake-to-review loop without the workflow wiring”.

    P5: guides/agent-workflows/build-a-triage-agent.mdx:124 — Next steps.

    Warp's product for running this same loop without the manual wiring.

    Principle: PDF pp.1–2: platform identity and bounded adoption.
    Recommendation: Change only the Next steps link description to the infrastructure alternative for a configured triage workflow. Preserve the standalone procedure and customer-owned skill improvement.

    P6: guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx:75 — Next steps.

    Warp's product for running this same loop without the manual wiring.

    Principle: PDF pp.1–2: platform identity and selectable workflows.
    Recommendation: Change only the Next steps link description to infrastructure for a configurable spec workflow. Keep human spec review and standalone authoring instructions.

    Contextual opportunity, not a blanket team-of-agents error

    O1: factories/how-factories-work.mdx:10. “A factory is a team of cloud agents connected to your repositories.”
    Principle: PDF pp.1–2: distinguish the infrastructure platform from a customer-configured factory.
    Recommendation: This lowercase factory definition describes an operational instance, not Warp Factories itself. Consider anchoring it to a factory the customer configures on Warp, especially for direct arrivals; retain useful team collaboration and stages. The same sentence appears in the root overview and factories overview. Coordinate with #884, not a blanket team-of-agents rewrite.

    Also: index.mdx:34.
    Also: factories/index.mdx:13.

    Evidence-boundary opportunities (technical follow-up, not certified runtime defects)

    These are adjacent scoping risks found during the audit, not permission to change security, model support, or product behavior from the strategy document. Verify the owning implementation or policy before public edits.

    E1: enterprise/enterprise-features/architecture-and-deployment.mdx:100 — When to use. “You want {VARS.WARP_AUTOMATION_PLATFORM} orchestration and visibility without sending code to Warp's infrastructure.”
    Principle: PDF pp.1–2 and evidence boundary: customer hosting/control is not proof of end-to-end data sovereignty.
    Recommendation: Scope the promise to repository checkout and execution. Preserve the same page’s explicit code context and transcript transit at lines 70 and 134–135; link the owning data-boundary reference. Technical owner verification is required before changing runtime claims.

    E2: enterprise/enterprise-features/byollm-gemini-enterprise.mdx:357 — Credential security. “Nothing sensitive leaves your boundary”
    Principle: Evidence boundary: configuration choice does not establish blanket data or credential isolation.
    Recommendation: Replace only the absolute bullet label with the specific no-upload/no-persistence claim for long-lived credential files. Retain the short-lived token/backend request route at line 39 and customer-governed retention caveats; verify those behaviors independently.

    E3: enterprise/index.mdx:54 — Agent capabilities. “Support for all major models and CLI coding agents ({VARS.WARP_AUTOMATION_PLATFORM}, Claude Code, Codex, Copilot)”
    Principle: PDF pp.2–5: strategic model/harness flexibility is not shipped universal compatibility.
    Recommendation: Point to the current supported model/harness references and distinguish desktop CLI integrations from cloud harnesses. Do not treat the Automation Platform as a harness or infer every listed CLI runs inside a factory. Replace the universal support phrase only after checking the surface-specific compatibility matrix.

    E4: support-and-community/plans-and-billing/pricing-faqs.mdx:263 — How can I enable Zero Data Retention in Warp?. “Regardless of plan, Warp never allows OpenAI, Anthropic, Google, xAI, or other model providers to store, retain, or train their models on your data”
    Principle: Evidence boundary: provider retention and customer-controlled routing require their own supported scope, not positioning proof.
    Recommendation: Reconcile this absolute sentence with the same page’s supported-model/provider-retention exception at line 253 and customer-provider configurations. Keep no-training, deletion timing, telemetry, and provider retention as separate claims; ask the privacy owner to validate the bounded wording.

    E5: agents/capabilities/codebase-context.mdx:5 — Frontmatter description. “No code is stored on Warp servers.”
    Principle: Evidence boundary: local indexing storage and cloud/run-data storage are different scopes.
    Recommendation: Narrow the summary to the documented indexing/storage scope rather than all code use. Reconcile the copied blanket wording in code/overview.mdx:97 and getting-started/quickstart/coding-in-warp.mdx:38 with platform/architecture.mdx:96–100. This is a reader-scope risk, not a new audited statement about runtime storage.

    E6: platform/triggers/scheduled-agents.mdx:52 — Common use cases. “Because each run is isolated, Scheduled Agents are safe to use for tasks that benefit from a clean, repeatable execution environment.”
    Principle: PDF pp.2–5: governance and control are reviewable capabilities, not unconditional safety guarantees.
    Recommendation: Describe a fresh repeatable session rather than safety established by isolation. Preserve the explicit persistent-environment exception and responsibility for access, costs, prompts, and production-changing actions at lines 301–323.

    Aligned material to preserve

    • factories/factory-agents.mdx:14: “These defaults are a starting point” Customer-selectable starting point, not prescribed team/workflow.
    • factories/factory-agents.mdx:26: “These are responsibilities, not a fixed pipeline.” Explicitly preserves workflow choice; retain agent collaboration.
    • factories/factory-as-code.mdx:11: “A factory definition is a versioned tree of YAML and Markdown files rooted at factory.yaml.” Inspectable customer configuration across selectable infrastructure primitives.
    • factories/measure-and-improve.mdx:10: “spot a problem, test a fix, and decide whether to keep it.” Measurement connects to an evidence-based improvement decision.
    • factories/measure-and-improve.mdx:35: “Cost per PR is a comparison metric, not a billing figure.” Preserves bounded economics rather than guaranteed ROI.
    • factories/benchmarks.mdx:72: “review the result as a comparison, not as a universal model ranking:” Fixed-task comparisons remain bounded, not universal outcomes.
    • factories/how-factories-work.mdx:63: “The first two are workflow policy, written into the foreman's instructions; edit them to change when the factory checks in.” Distinguishes customer workflow policy from enforced repository permissions.

    Keep supported APIs/SDKs, hosting and data boundaries, integration procedures, named runtime compatibility, default-agent collaboration, and ordinary terminal/Warp Drive material. Dated changelogs are historical context, not current support promises. No factory slogan is required on unrelated pages.

    Overlap and scope

    Responding as Docs Factory (V2): Open session · View in factory

  3. warp-agent-staging commented on Nov 10, 2026

    @warp-agent-staging
    warp-agent-stagingBot
    on Nov 10, 2026 – with Warp Agent Staging
    ContributorAuthor

    Whole-corpus coverage ledger

    Pinned corpus: a571309952bb011f2f5d09a6b2dcab34e6abaa35. 418/418 pages accounted for: 417 full-source semantic reads (438,056 words excluding the legal page) plus framing review of the generated third-party-license page. Full page bodies, frontmatter, examples, source alt text, captions, and named-variable expansions were included; keyword search only assisted consistency checks.

    The 204,041-word dependency/legal body was excluded from line-by-line positioning review. Embedded media, external destination pages, live product behavior, and non-Markdown API schemas were not independently audited. Source media text was included. These exclusions mean this is not a claim to have read every word of the 642,097-word source corpus.

    All paths below are relative to src/content/docs/. SHA is the first 12 characters of the source SHA-256; full hashes, line ranges, findings, and exact verification are attached to the task as JSON artifact 01a1c664-8b22-7c5b-864e-466cc66805ed. This comment is the durable page-by-page manifest, independent of the remote filesystem.

    Dispositions: P confirmed conflict; O contextual editorial opportunity; E technical evidence-boundary opportunity; A aligned infrastructure/configuration; N no factory-positioning conflict; H historical release context; X framing read, legal body excluded. Multiple letters mean multiple dispositions.

    Page Disposition Source SHA-256 prefix
    404.mdx N 5bab488c7c48
    agents/agent-memory/index.mdx N 2e8a4fc048f9
    agents/capabilities/agent-notifications.mdx N ff4bb63b039d
    agents/capabilities/agent-profiles-permissions.mdx N 521d8c61b8a4
    agents/capabilities/codebase-context.mdx E (E5) 78c09da22234
    agents/capabilities/computer-use/artifacts-in-prs.mdx N 39565db2c69d
    agents/capabilities/computer-use/browser-use.mdx N 84ac06e7d114
    agents/capabilities/computer-use/index.mdx N 3aad562691a0
    agents/capabilities/computer-use/testing-and-recordings.mdx N e6f087ddcc2c
    agents/capabilities/full-terminal-use.mdx N d30f22d53e89
    agents/capabilities/index.mdx N af089036229d
    agents/capabilities/mcp.mdx N a696c4159f0c
    agents/capabilities/planning.mdx N 2cbc44fe4c66
    agents/capabilities/rules.mdx N df1376f9b402
    agents/capabilities/skills.mdx N d80a0b9c0906
    agents/capabilities/slash-commands.mdx N 4a189ce2c81a
    agents/capabilities/task-lists.mdx N a876d695a295
    agents/capabilities/web-search.mdx N 85ce9b45cbb4
    agents/cli/agent-conversations.mdx N 704db3c711c8
    agents/cli/cloud-and-orchestration.mdx N a50e3088fd97
    agents/cli/configuration.mdx N b91d812a509d
    agents/cli/index.mdx N c8111e567e53
    agents/cli/input-and-shell-commands.mdx N dbc501a54943
    agents/cli/models-and-usage.mdx N 41797e419430
    agents/cli/oz-cli/agent-profiles.mdx N 2b5038b0fed9
    agents/cli/oz-cli/api-keys.mdx N 78b31b4eaa9d
    agents/cli/oz-cli/artifacts.mdx N 86167d23325e
    agents/cli/oz-cli/federate.mdx N 31f258cd2c49
    agents/cli/oz-cli/index.mdx N 863fa7ffcad2
    agents/cli/oz-cli/integration-setup.mdx N ee2fb87fbfed
    agents/cli/oz-cli/mcp-servers.mdx N 57a68230dfd6
    agents/cli/oz-cli/quickstart.mdx N 6f42e5f9a110
    agents/cli/oz-cli/skills.mdx N 08c6719b0560
    agents/cli/oz-cli/troubleshooting.mdx N 50f355b5461c
    agents/cli/oz-cli/warp-drive.mdx N 7247a08f2a0e
    agents/cli/permissions-and-profiles.mdx N d2fb161547a8
    agents/cli/quickstart.mdx N afb060dea200
    agents/cli/reference.mdx N e7fce7b75f9d
    agents/cli-agents/claude-code.mdx N 2cdc38130ba2
    agents/cli-agents/codex.mdx N e2273e8b963d
    agents/cli-agents/opencode.mdx N cb8c446d84b0
    agents/cli-agents/overview.mdx N 97711aa2f470
    agents/cli-agents/remote-control.mdx N a5c914f9eb71
    agents/cli-agents/rich-input.mdx N 46a19b658f65
    agents/getting-started/faqs.mdx N 636283edba95
    agents/index.mdx N 035829b034ac
    agents/inference/bring-your-own-api-key.mdx N db6e672f8a40
    agents/inference/chatgpt-subscription.mdx N fded0923b0f7
    agents/inference/custom-inference-endpoint.mdx N 639e59ff1326
    agents/inference/custom-routers.mdx N 2484318832fc
    agents/inference/grok-subscription.mdx N 767a5a2acb7e
    agents/inference/model-choice.mdx N 3218230250af
    agents/local-agents/active-ai.mdx N 5e69ee2a8db2
    agents/local-agents/agent-context/blocks-as-context.mdx N 66cc67cc3239
    agents/local-agents/agent-context/images-as-context.mdx N f6cbe014f1e5
    agents/local-agents/agent-context/index.mdx N e17549d9557e
    agents/local-agents/agent-context/selection-as-context.mdx N ff157ceca7e5
    agents/local-agents/agent-context/urls-as-context.mdx N ba7c384db56b
    agents/local-agents/agent-context/using-to-add-context.mdx N 296401fd581d
    agents/local-agents/cloud-conversations.mdx N 2f7d8ba8a718
    agents/local-agents/code-diffs.mdx N e72c63ed9a6d
    agents/local-agents/generate.mdx N d1ce3d9338e8
    agents/local-agents/interacting-with-agents/agent-questions.mdx N 34c26bccf909
    agents/local-agents/interacting-with-agents/conversation-forking.mdx N 6d5b1d050101
    agents/local-agents/interacting-with-agents/index.mdx N e299ad193262
    agents/local-agents/interacting-with-agents/prompt-queueing.mdx N 1f33eeae8647
    agents/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx N cd35fb2146cf
    agents/local-agents/interacting-with-agents/voice.mdx N dbd3e40a9553
    agents/local-agents/interactive-code-review.mdx N 346189dfa149
    agents/local-agents/session-sharing.mdx N daea2152f6dd
    changelog/2021.mdx H 71c7f22f8ad4
    changelog/2022.mdx H 14df066c48d7
    changelog/2023.mdx H 58397180e673
    changelog/2024.mdx H 8c7d4a55d3c1
    changelog/2025.mdx H cca77d85e68d
    changelog/2026.mdx H 80a518271231
    changelog/index.mdx H 2b5406108eb0
    code/code-editor/code-editor-vim-keybindings.mdx N 78c4b8bc02d2
    code/code-editor/file-tree.mdx N cbdc1df21048
    code/code-editor/find-and-replace.mdx N d077d60dfa8c
    code/code-editor/index.mdx N bfa3cffe677b
    code/code-editor/language-server-protocol.mdx N 90944776988f
    code/code-review.mdx N d8581a2368fe
    code/git-worktrees.mdx N a09edc43576b
    code/overview.mdx E (E5) 425249be66f2
    code/ssh-feature-support.mdx N 6f53390fd333
    enterprise/enterprise-features/analytics-api.mdx N 9fd7dfc0a118
    enterprise/enterprise-features/architecture-and-deployment.mdx E (E1) 49a89792a39b
    enterprise/enterprise-features/bring-your-own-llm.mdx N c4d5066c7179
    enterprise/enterprise-features/byollm-aws-bedrock.mdx N 1d856d5849a8
    enterprise/enterprise-features/byollm-gemini-enterprise.mdx E (E2) 367447eda857
    enterprise/enterprise-features/private-networking.mdx N 28bd9e67d159
    enterprise/enterprise-features/team-managed-keys-and-endpoints.mdx N 18d534eb3c0d
    enterprise/getting-started/faq.mdx N 0e37970b6712
    enterprise/getting-started/getting-started-developers.mdx N d31e1ff2470f
    enterprise/getting-started/getting-started-enterprise.mdx N cda9018e195b
    enterprise/getting-started/quickstart.mdx N 62916288216d
    enterprise/index.mdx P/E (P3, E3) 31acfaf2b81a
    enterprise/security-and-compliance/security-overview.mdx N 02eb86f32e54
    enterprise/security-and-compliance/sso.mdx N 3f44898b5913
    enterprise/security-and-compliance/trust-center.mdx N 00b8a912490b
    enterprise/support-and-resources/billing.mdx N 56a2df7a603e
    enterprise/support-and-resources/feedback-and-feature-requests.mdx N afe0353b2077
    enterprise/support-and-resources/troubleshooting-login.mdx N 2135a24098ef
    enterprise/team-management/admin-panel.mdx N af83c82b3603
    enterprise/team-management/roles-and-permissions.mdx N c9a095907343
    enterprise/team-management/teams.mdx N a6ed7e2b8aae
    enterprise/team-management/workspaces.mdx N 6f83e912f7e3
    factories/api-and-sdk/demo-sentry-monitoring-with-sdk.mdx A 92a17a6578d5
    factories/api-and-sdk/index.mdx A 37d1957344f9
    factories/api-and-sdk/quickstart.mdx A 40869512b3c0
    factories/api-and-sdk/troubleshooting/errors/agent-process-failed.mdx A f499e2120e0f
    factories/api-and-sdk/troubleshooting/errors/authentication-required.mdx A f67bb2c7246c
    factories/api-and-sdk/troubleshooting/errors/budget-exceeded.mdx A 5c1b8e894b53
    factories/api-and-sdk/troubleshooting/errors/conflict.mdx A ca43ad5eb339
    factories/api-and-sdk/troubleshooting/errors/content-policy-violation.mdx A 344dc190aff0
    factories/api-and-sdk/troubleshooting/errors/environment-setup-failed.mdx A 3a655732fb28
    factories/api-and-sdk/troubleshooting/errors/external-authentication-required.mdx A c1f099a11513
    factories/api-and-sdk/troubleshooting/errors/feature-not-available.mdx A 4f568ea251fd
    factories/api-and-sdk/troubleshooting/errors/index.mdx A 533bf15b2064
    factories/api-and-sdk/troubleshooting/errors/infrastructure-timeout.mdx A 483d3c650a8b
    factories/api-and-sdk/troubleshooting/errors/insufficient-credits.mdx A e8680dc5349e
    factories/api-and-sdk/troubleshooting/errors/integration-disabled.mdx A 059b157ca3e2
    factories/api-and-sdk/troubleshooting/errors/integration-not-configured.mdx A 0bd85cdc8db1
    factories/api-and-sdk/troubleshooting/errors/internal-error.mdx A 387559bbc7fe
    factories/api-and-sdk/troubleshooting/errors/invalid-request.mdx A 9ffb594f5076
    factories/api-and-sdk/troubleshooting/errors/not-authorized.mdx A 2b547fca6732
    factories/api-and-sdk/troubleshooting/errors/operation-not-supported.mdx A 52eece9742fc
    factories/api-and-sdk/troubleshooting/errors/resource-not-found.mdx A 9e825a770d61
    factories/api-and-sdk/troubleshooting/errors/resource-unavailable.mdx A 709a0d4a0a46
    factories/automation-triggers.mdx A 0481da99b1e6
    factories/automations.mdx A 0f1f99b1134c
    factories/benchmarks.mdx A 6ff5b90d2636
    factories/code-forges/other-code-forges.mdx A f650fc0fbfd9
    factories/connect-your-factory.mdx A b8d066e1f291
    factories/deployment-patterns.mdx A 9c980785ce39
    factories/developer-tools.mdx A e4c7a13a52a7
    factories/environments/configuring-environments.mdx A 160fbf520b63
    factories/environments/troubleshooting-environments.mdx A e6af10e9e9e5
    factories/environments.mdx A 05c8c1e7e527
    factories/factory-agents/configuration.mdx A 20df5bedc886
    factories/factory-agents/creating-custom-agents.mdx A 0953b30b4fc7
    factories/factory-agents.mdx A 41673471c884
    factories/factory-api.mdx A bcbf722f2d9a
    factories/factory-as-code.mdx A fc174dfd486c
    factories/factory-dashboard.mdx A b7c9421a8a35
    factories/factory-inbox.mdx A 160a213fb69f
    factories/factory-mcp.mdx A 8823214436da
    factories/factory-skills.mdx A 87bddf3430f3
    factories/guides/github-issue-to-pull-request.mdx A e5b52bc5a756
    factories/guides/index.mdx A cd720d8cbc90
    factories/guides/jira-to-pull-request.mdx A 81fda693d9e0
    factories/guides/linear-to-pull-request.mdx A ab7af42d65df
    factories/guides/microservices-factory.mdx A 00dfc6b3ede2
    factories/guides/monorepo-factory.mdx A d9c9f4d4c6c4
    factories/guides/multi-repository-factory.mdx A a2aa0ead609a
    factories/guides/slack-to-pull-request.mdx A 6e9410606b75
    factories/guides/structuring-your-factory.mdx A fa5ea993d51c
    factories/guides/testing-and-tuning-your-factory.mdx A 35b1dc43128c
    factories/guides/web-application-factory.mdx A e97c00194254
    factories/harnesses/authentication.mdx A 529923e06c17
    factories/harnesses/claude-code.mdx A 1bbf366d8dcd
    factories/harnesses/codex.mdx A 2a5ad3fc8854
    factories/harnesses/index.mdx A d287d9e87439
    factories/harnesses/warp-agent.mdx A 5eff47051ba5
    factories/how-factories-work.mdx O (O1) e8ccdd9dce00
    factories/index.mdx P/O (P1, O1) 591b834fb1e9
    factories/infrastructure-and-security.mdx A b53bb7f472c0
    factories/integrations/azure-devops.mdx A 358e2632003f
    factories/integrations/github.mdx A 70ed6554b98d
    factories/integrations/gitlab.mdx A 4c234ede54f6
    factories/integrations/jira.mdx A b94cbb396a18
    factories/integrations/linear.mdx A 5a327388c142
    factories/integrations/permissions.mdx A 4bfd7091f87d
    factories/integrations/slack.mdx A 3697a2128f55
    factories/integrations/teams.mdx A c6e64f6d6be0
    factories/mcp.mdx A bd76594ffa49
    factories/measure-and-improve/scorers.mdx A 18a735fbe492
    factories/measure-and-improve/self-improvement.mdx A 5ca1b8e966ca
    factories/measure-and-improve.mdx A cee47c45e842
    factories/permissions.mdx A 0c83da400dc7
    factories/quickstart.mdx A 9602578606f0
    factories/runners.mdx A a8b04223c65e
    factories/secrets/aws-ecr.mdx A 3c7fe8e4f6dd
    factories/secrets.mdx A 00b21dea05d5
    factories/self-hosting/data-storage.mdx A fa58ca2a0cf5
    factories/self-hosting/direct-monorepo-worktrees.mdx A 58ae8511fa26
    factories/self-hosting/external-orchestrators.mdx A 85e56d156fa0
    factories/self-hosting/index.mdx A 8dbc02e04b6a
    factories/self-hosting/managed-direct.mdx A 4d9bb466cda2
    factories/self-hosting/managed-docker.mdx A 2d812ecf1171
    factories/self-hosting/managed-kubernetes.mdx A 5c5145c4b9bf
    factories/self-hosting/monitoring.mdx A 3c639475fe0e
    factories/self-hosting/private-container-registry.mdx A 6c3066bfac5b
    factories/self-hosting/quickstart.mdx A 4387bb9d93ff
    factories/self-hosting/reference.mdx A 3fbc9d2248b1
    factories/self-hosting/security-and-networking.mdx A 09499f22e491
    factories/self-hosting/troubleshooting.mdx A 86c83783f72c
    factories/troubleshooting.mdx A 4817542c46b1
    factories/use-cases/code-review.mdx A 9aec1b3d73f5
    factories/use-cases/computer-use-verification.mdx A 5e97410d23e2
    factories/use-cases/end-to-end-sdlc-automation.mdx A ab768d4f109b
    factories/use-cases/index.mdx A 1d6e4eca3a4e
    factories/use-cases/issue-implementation.mdx A 66b56ce8e110
    factories/use-cases/issue-triage.mdx A ca1f3a612b2e
    factories/use-cases/production-incident-resolution.mdx A e07c22e54c98
    factories/warp-hosting.mdx A b49865f6b46e
    factories/webhooks/vercel.mdx A 72d433c4e102
    factories/webhooks.mdx A 09c3f7063cba
    getting-started/keyboard-shortcuts.mdx N 321ba4655788
    getting-started/migrate-to-warp/index.mdx N 9e6ace6685df
    getting-started/migrate-to-warp/migrate-to-warp-from-claude-code.mdx N 905ebab7d6e6
    getting-started/migrate-to-warp/migrate-to-warp-from-cursor.mdx N 11257dc95862
    getting-started/migrate-to-warp/migrate-to-warp-from-ghostty.mdx N 1fb4f5564f78
    getting-started/migrate-to-warp/migrate-to-warp-from-iterm2.mdx N 238927f90ac7
    getting-started/migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx N 972c0b9401bf
    getting-started/migrate-to-warp/migrate-to-warp-from-vs-code-terminal.mdx N 3dbd48ad6533
    getting-started/migrate-to-warp/migrate-to-warp-from-windows-terminal.mdx N ad1b28766bfd
    getting-started/quickstart/coding-in-warp.mdx E (E5) 4475977b94f8
    getting-started/quickstart/customizing-warp.mdx N 9972a92660e8
    getting-started/quickstart/installation-and-setup.mdx N 8919b2e913b9
    getting-started/supported-shells.mdx N 970331a82128
    guides/agent-workflows/build-a-self-improving-agent.mdx N 24d8295a9c6a
    guides/agent-workflows/build-a-triage-agent.mdx P (P5) 36263cc2bc2e
    guides/agent-workflows/how-to-attach-agent-session-context-to-github-prs.mdx N 479f24b2a2a9
    guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx N c6c59bf312ef
    guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx N d67c8c0397f9
    guides/agent-workflows/how-to-review-ai-generated-code.mdx N 267c5c86ea9a
    guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx N 29f00a1c0346
    guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx N 188e0abf77e0
    guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx N 8aafcfe70a88
    guides/agent-workflows/how-to-run-unattended-agents.mdx N 1982eec3a960
    guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx N 77d6ece4694a
    guides/agent-workflows/set-up-a-software-factory.mdx P (P4) 2a0a0f3545c4
    guides/agent-workflows/understanding-your-codebase.mdx N 757bc9a73424
    guides/agent-workflows/using-images-as-context-with-warp.mdx N 9b368af9b6a3
    guides/agent-workflows/warp-for-product-managers.mdx N 96f83a2f63d6
    guides/agent-workflows/warp-vs-claude-code.mdx N bb9333f08b80
    guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx P (P6) 5f6da085ac5a
    guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx N bb1c168bfba4
    guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx N f00867c6892b
    guides/build-an-app-in-warp/building-warps-input-with-warp.mdx N 9dc83e9ca438
    guides/configuration/creating-rules-for-agents.mdx N c9389ebe4b0a
    guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx N ae1a0da25ee4
    guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx N 5202fd9ca3ce
    guides/configuration/how-to-set-coding-best-practices.mdx N f8418a2d535f
    guides/configuration/how-to-set-coding-preferences-with-rules.mdx N ad5b3c7db3e8
    guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx N e0c7748c3005
    guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx N 069557d8de7d
    guides/configuration/how-to-sync-your-monorepos.mdx N 81fa58251a2a
    guides/configuration/how-to-use-tokens-efficiently-with-ai-coding-agents.mdx N 7a7f593cffb2
    guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx N 3060168d793a
    guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx N 873fb59c2b7f
    guides/devops/how-to-create-a-production-ready-docker-setup.mdx N e0756c1e5c87
    guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx N 0c7b495ff3f9
    guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx N 862324bd623e
    guides/devops/how-to-prevent-secrets-from-leaking.mdx N 9a157d7fa2c9
    guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx N 785cd115cfd4
    guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx N e7fae472eee2
    guides/external-tools/build-a-mattermost-bot-for-warp-factories.mdx N 70ccb46ad58e
    guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx N 2c9f42863150
    guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx N 9d17a0a13a41
    guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx N 8e5b14ee15b9
    guides/external-tools/how-to-set-up-claude-code.mdx N a3045418d58c
    guides/external-tools/how-to-set-up-codex-cli.mdx N 57029cdc0391
    guides/external-tools/how-to-set-up-gemini-cli.mdx N e4aea712cf36
    guides/external-tools/how-to-set-up-ollama.mdx N da0254c4774b
    guides/external-tools/how-to-set-up-opencode.mdx N d9c2c7995c46
    guides/external-tools/linear-mcp-retrieve-issue-data.mdx N a7589872babd
    guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx N af4b368479f4
    guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx N e9eeb3fbe8c2
    guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx N e74476574d22
    guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx N 5dc3d124edcc
    guides/external-tools/using-mcp-servers-with-warp.mdx N cd5b0e0b4765
    guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind.mdx N 3ce27937bc8e
    guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx N 7ab8e2ca70c3
    guides/getting-started/10-coding-features-you-should-know.mdx N f1648092bb65
    guides/getting-started/how-to-customize-warps-appearance.mdx N 903623f3cb75
    guides/getting-started/how-to-make-warps-ui-more-minimal.mdx N ce86693eeb7b
    guides/getting-started/how-to-master-warps-code-review-panel.mdx N 0197242fe533
    guides/getting-started/welcome-to-warp.mdx N 6931f2e56c88
    guides/index.mdx N b8500b453b87
    index.mdx O (O1) 3522cd6cc9da
    knowledge-and-collaboration/admin-panel.mdx N e17cf80a3047
    knowledge-and-collaboration/session-sharing/index.mdx N 715ea0f65b21
    knowledge-and-collaboration/teams.mdx N b9adc648143e
    knowledge-and-collaboration/warp-drive/agent-mode-context.mdx N e9f1684bf3e0
    knowledge-and-collaboration/warp-drive/ai-objects.mdx N fc81562dd706
    knowledge-and-collaboration/warp-drive/environment-variables.mdx N 23ab569402f5
    knowledge-and-collaboration/warp-drive/index.mdx N 1c629f7592ca
    knowledge-and-collaboration/warp-drive/notebooks.mdx N 1fbf3f25e166
    knowledge-and-collaboration/warp-drive/prompts.mdx N 5cdc36eac1a3
    knowledge-and-collaboration/warp-drive/web.mdx N a6ba7387511c
    knowledge-and-collaboration/warp-drive/workflows.mdx N 88d6473da97f
    platform/agents.mdx N 8490b7210bb4
    platform/architecture.mdx N 9c4ad218a6a6
    platform/faqs.mdx N 729133ce21ee
    platform/handoff/cloud-to-cloud.mdx N 1858ab51d738
    platform/handoff/index.mdx N 64f1fd1be175
    platform/handoff/local-to-cloud.mdx N 0dd8d61e4116
    platform/handoff/snapshots.mdx N 34f261290018
    platform/index.mdx N c134b4b86ac5
    platform/integrations/azure-devops.mdx N e298eab20596
    platform/integrations/bitbucket.mdx N cdd3f65b36a1
    platform/integrations/cloud-providers.mdx N 0a1e3bfcd685
    platform/integrations/github-actions.mdx N 4f52becebc7a
    platform/integrations/github.mdx N 4ac304c22df3
    platform/integrations/gitlab.mdx N 0a4f0e2dbbcd
    platform/integrations/index.mdx N 30bd90f3531f
    platform/integrations/jira.mdx N e18d4a0e1c27
    platform/integrations/linear.mdx N 684bdac46f5f
    platform/integrations/quickstart-github-actions.mdx N 990ac0860435
    platform/integrations/quickstart.mdx N bf28c8dd9751
    platform/integrations/slack.mdx N 727117784493
    platform/managing-cloud-agents.mdx N e3ce29445df7
    platform/orchestration/index.mdx N 1397abc07918
    platform/orchestration/multi-agent-runs.mdx N 1a5dffb9faa5
    platform/overview.mdx A 85ce1abcdcfe
    platform/oz-web-app.mdx N 2e8cc1b8c348
    platform/quickstart.mdx N a7dbc72c0191
    platform/secrets.mdx N cad7c73ed267
    platform/team-access-billing-and-identity.mdx N 7463ea50dd5a
    platform/transitioning-from-oz.mdx P (P2) 81d47e5737a1
    platform/triggers/index.mdx N 5b4eadb96afc
    platform/triggers/scheduled-agents-quickstart.mdx N 623c8a7e151f
    platform/triggers/scheduled-agents.mdx E (E6) f5f089df8d09
    platform/unmanaged-execution.mdx N 080b6dfe4e82
    platform/viewing-cloud-agent-runs.mdx N e856e8b2d015
    quickstart.mdx N 0db65b56d779
    support-and-community/community/contributing.mdx N 38fd410ed9a2
    support-and-community/community/open-source-licenses.mdx X a4b9486faaf8
    support-and-community/community/refer-a-friend.mdx N 7da26d6b53e0
    support-and-community/community/warp-preview-and-alpha-program.mdx N 1d2871c4d8d4
    support-and-community/index.mdx N 5a1e7cc94f03
    support-and-community/plans-and-billing/add-on-credits.mdx N 29ce57914fd0
    support-and-community/plans-and-billing/credits.mdx N 70774a6baab5
    support-and-community/plans-and-billing/index.mdx N 9c8a57372e2e
    support-and-community/plans-and-billing/plans-pricing-refunds.mdx N f471db2b2146
    support-and-community/plans-and-billing/platform-credits.mdx N 38af31c8c3d1
    support-and-community/plans-and-billing/pricing-faqs.mdx E (E4) e24912e95000
    support-and-community/privacy-and-security/network-log.mdx N 4972618cecd7
    support-and-community/privacy-and-security/privacy.mdx N 70854687904e
    support-and-community/privacy-and-security/secret-redaction.mdx N ffc2276df3d6
    support-and-community/troubleshooting-and-support/known-issues.mdx N a3aca43c16ad
    support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx N bb3c9e85b764
    support-and-community/troubleshooting-and-support/sending-us-feedback.mdx N 21ff8c0ab119
    support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx N 316f90e4de44
    support-and-community/troubleshooting-and-support/updating-warp.mdx N b81b1012784c
    support-and-community/troubleshooting-and-support/using-warp-offline.mdx N 03ee25d92177
    terminal/appearance/app-icons.mdx N 3a1508e017af
    terminal/appearance/blocks-behavior.mdx N dd4846027a0c
    terminal/appearance/custom-themes.mdx N 2fe93e4e388a
    terminal/appearance/index.mdx N 3f21bc36fefd
    terminal/appearance/input-position.mdx N fb74c8eee661
    terminal/appearance/pane-dimming.mdx N f1e43979bbe8
    terminal/appearance/prompt.mdx N 9a1985df6e6a
    terminal/appearance/size-opacity-blurring.mdx N ada4308bab09
    terminal/appearance/tabs-behavior.mdx N 563a679059ce
    terminal/appearance/text-fonts-cursor.mdx N 9e2f9eb46246
    terminal/appearance/themes.mdx N 11c3c37de34b
    terminal/blocks/background-blocks.mdx N 175e900544b2
    terminal/blocks/block-actions.mdx N 364c37d6309c
    terminal/blocks/block-basics.mdx N afd806729c97
    terminal/blocks/block-filtering.mdx N fdb2e7171982
    terminal/blocks/block-sharing.mdx N 47c04d181ba1
    terminal/blocks/find.mdx N f2657ab2df16
    terminal/blocks/index.mdx N 8af1dd06b973
    terminal/blocks/sticky-command-header.mdx N bcc723529be2
    terminal/command-completions/autosuggestions.mdx N a1701fad5fdc
    terminal/command-completions/completions.mdx N 7ea70059e8a0
    terminal/command-completions/index.mdx N bfaa92b7684d
    terminal/command-palette.mdx N 13fd7f71aa71
    terminal/comparisons/index.mdx N 232177054899
    terminal/comparisons/performance.mdx N 43e3ce44b28f
    terminal/comparisons/terminal-features.mdx N 702673808023
    terminal/editor/alias-expansion.mdx N 743bb77f815f
    terminal/editor/command-inspector.mdx N 2bf4aafff819
    terminal/editor/index.mdx N 7dc04cf068b7
    terminal/editor/syntax-error-highlighting.mdx N 80db74399e1a
    terminal/editor/vim.mdx N fd4b2d5217ca
    terminal/entry/command-corrections.mdx N e7a786cf1ed0
    terminal/entry/command-history.mdx N 4ad753ebc164
    terminal/entry/command-search.mdx N e9d844fe3ff4
    terminal/entry/index.mdx N b97b5d51632d
    terminal/entry/synchronized-inputs.mdx N c0d80f7ee3d8
    terminal/entry/yaml-workflows.mdx N 08ad08b7a460
    terminal/integrations-and-plugins.mdx N 9fe1017f0aef
    terminal/more-features/accessibility.mdx N 31e53435f245
    terminal/more-features/audible-bell.mdx N 7495b63dc074
    terminal/more-features/files-and-links.mdx N 41e859bfd19a
    terminal/more-features/full-screen-apps.mdx N 851b8fee6e65
    terminal/more-features/index.mdx N 3c345df39e50
    terminal/more-features/linux.mdx N 4cccd4565906
    terminal/more-features/markdown-viewer.mdx N 279a95cfe35a
    terminal/more-features/notifications.mdx N 9af5af2415c1
    terminal/more-features/quit-warning.mdx N 4b1d446e9260
    terminal/more-features/settings-sync.mdx N 7f5737469b76
    terminal/more-features/text-selection.mdx N c6c4269f6842
    terminal/more-features/uri-scheme.mdx N 96e0b0aaba9f
    terminal/more-features/working-directory.mdx N ba3824c50533
    terminal/sessions/index.mdx N 01cbac24f368
    terminal/sessions/launch-configurations.mdx N ba8573794c0b
    terminal/sessions/session-navigation.mdx N 5a3fd7ce4092
    terminal/sessions/session-restoration.mdx N 232bdccd2383
    terminal/settings/all-settings.mdx N be6862dcca98
    terminal/settings/file-locations.mdx N da4560da5816
    terminal/settings/index.mdx N 2296da1d1c57
    terminal/warpify/index.mdx N d80fdfbe2f94
    terminal/warpify/ssh-legacy.mdx N 875c31959761
    terminal/warpify/ssh.mdx N d80fa94809ad
    terminal/warpify/subshells.mdx N 7a319ebe196a
    terminal/windows/configurable-toolbar.mdx N 8e0f810bab27
    terminal/windows/global-hotkey.mdx N b673289b58e8
    terminal/windows/index.mdx N eb06726635a1
    terminal/windows/split-panes.mdx N 857fc52a2457
    terminal/windows/tab-configs.mdx N 34a210ef5004
    terminal/windows/tabs.mdx N 18bf328d369b
    terminal/windows/vertical-tabs.mdx N 7cc688a2c384

    Shared rendering and name surfaces

    • src/data/vars.ts: Names and URLs retained: Automation Platform, Oz CLI versus Warp Agent CLI, factory web app. Internal product/instance comment at lines 26–28 is non-rendered context, not public identity copy; no runtime name changes.
    • src/sidebar.ts: Complete navigation read: factory/default/workflow labels preserved; availability badge recorded, not certified by positioning evidence.
    • src/content.config.ts: Frontmatter names are expanded in schema before title/description/sidebar rendering.
    • src/plugins/vars-transform.ts: Frontmatter variable substitution inspected; audit batch renderer expands the same named values.
    • src/plugins/heading-vars.ts: Heading expressions resolved from shared names before anchor/TOC generation.
    • src/components/CustomPageTitle.astro: Page descriptions render as visible subtitles as well as metadata; P1 therefore affects both snippet and on-page lede.
    • src/components/CustomHead.astro: Shared organization/site identity is Warp; per-page metadata delegated to route data.
    • src/components/CustomHeader.astro: Shared header renders topic labels, no additional factory identity prose.
    • src/components/WarpTopicNav.astro: Topic labels/badges render from sidebar; no additional factory definition.
    • src/routeData.ts: Page descriptions propagate to social metadata; titles append Warp, not a duplicate factory definition.
    • astro.config.mjs: Site identity and configured shared rendering inspected; no factory claim requiring a global rename.

    Base-sync addendum

    Before PR creation, main advanced to c93cbe15199836bd409762e013db22af0cfe4ed9. Read the five changed/new public pages below completely, plus the navigation delta; Inbox was replaced by Home. This is upstream work, not a public-page edit in the guidance PR. The new base still contains 418 public pages.

    • factories/factory-dashboard.mdx: complete-source-read; Read complete new-base page: human attention, configurable agents, metrics, bounded first task or diagnostic workflow; no new positioning conflict.
    • factories/factory-home.mdx: complete-source-read; Read complete new-base page: human attention, configurable agents, metrics, bounded first task or diagnostic workflow; no new positioning conflict.
    • factories/factory-inbox.mdx: removed-on-new-base; Original page remains in pinned audit; base replaces Inbox with Home, not a positioning edit by this request.
    • factories/how-factories-work.mdx: complete-source-read; Read complete new-base page. Existing contextual factory-instance opening retained as O1; Home/Waiting on you operational updates add no new platform identity conflict.
    • factories/quickstart.mdx: complete-source-read; Read complete new-base page: human attention, configurable agents, metrics, bounded first task or diagnostic workflow; no new positioning conflict.
    • factories/troubleshooting.mdx: complete-source-read; Read complete new-base page: human attention, configurable agents, metrics, bounded first task or diagnostic workflow; no new positioning conflict.

    Guidance verification

    • python3 -m unittest discover -s .agents/skills/doc_quality_policy -p test_editorial_guidance.py -v: 17 passed; both new tests fail on the pinned original guidance and pass after the change.
    • python3 -m unittest discover -s .agents/skills/doc_quality_policy -p 'test_*.py': 145 passed.
    • python3 .agents/skills/style_lint/test_factory_proper_noun.py: all 27 cases passed; lint detection behavior unchanged, diagnostic copy aligned.
    • python3 .agents/skills/style_lint/style_lint.py --changed: zero files scanned, zero issues (no changed public pages).
    • python3 .agents/skills/check_for_broken_links/check_links.py --internal-only: original base passed 418 pages/4,940 links. Final head and isolated new main both fail on the same three old /factories/factory-inbox/ references: factories/guides/slack-to-pull-request.mdx:83, factories/use-cases/end-to-end-sdlc-automation.mdx:168, factories/use-cases/issue-implementation.mdx:186 (418 pages/4,941 links). Public src tree hash is identical between main and delivery.
    • python3 -m py_compile .agents/skills/style_lint/style_lint.py .agents/skills/doc_quality_policy/test_editorial_guidance.py: passed.
    • python3 -m json.tool .agents/skills/draft_docs/evals/evals.json: passed.
    • Factory-config python3 -m unittest discover -s tests -p 'test_*.py': 39 passed.
    • git --no-pager diff origin/main...HEAD --check: passed in both repositories.
    • trunk check and trunk fmt: unavailable (trunk not installed), not passing.
    • Site build/typecheck/UI capture and factory-schema service validation not triggered: no site/public content or factory-resource configuration changes. External-link checks and an LLM evaluation run were not performed.
    • Full final diff read after base merge; deletion-only cut pass and test keep/delete pass completed. No new comment lines, scratch artifacts, or published-page edits in the PR diff.

    Responding as Docs Factory (V2): Open session · View in factory

  4. warp-agent-staging commented on Nov 10, 2026

    @warp-agent-staging
    warp-agent-stagingBot
    on Nov 10, 2026 – with Warp Agent Staging
    ContributorAuthor

    Guidance delivered for independent review: docs#1012 at a59d6c4a2f8545acd9bc0c6ce90a9d0e9de75f19 and factory-config#34 at 30da5c51880ed404461d8862e1f3ccd51a8155d6. Both remain draft; public-copy findings and full coverage are recorded above.

    Responding as Docs Factory (V2): Open session · View in factory

  5. rachaelrenk commented on Nov 10, 2026

    @rachaelrenk
    rachaelrenk
    on Nov 10, 2026
    Contributor

    Implementation is now on the existing PR branches; nothing has been merged or published.

    • docs#1012: rename the canonical guidance to warp-positioning.md, remove the customer-factory team exception, make the repo glossary authoritative without the Notion Dictionary, and add writing examples, regressions, and evaluation inputs.
    • docs#884: supersede the original AEO experiment with infrastructure-positioning corrections across nine existing pages, including all six confirmed-copy findings and the priority root/factory/how-it-works openings. Shipped role names and existing workflow instructions are preserved.
    • docs-factory-config#34: load the canonical guidance and prepare separate positioning and voice scorers with automatic scoring paused and self-improvement off.
    • examples#3: positioning corrections added directly to the existing PR; the pinned default-agent snapshot remains unchanged.
    • common-skills#116: new draft PR is necessary to update the maintained engineer-facing writing skill in its own repository. Installed copies are not yet refreshed.

    Local checks include 148 docs-policy tests, 42 factory tests, four positioning-test groups, 27 naming cases, the docs build/typecheck/heading checks, and parser validation for all 16 examples. No new lint findings were introduced in the nine corrected pages. The complete v1alpha2 factory submission had no parser diagnostics; state-dependent apply checks were not run.

    Remaining gates: human review/merge, paid evaluation budget and human calibration, consumer refresh after the guidance merge, and explicit live-scorer activation approval. The docs CI link check still finds the same three unchanged /factories/factory-inbox/ references from main. The hosted review of #884 failed with an authentication 401, so independent review is not complete. The new lint check's CodeQL comment-terminator finding was corrected and regression-tested; fresh scans are running. The separate technical-evidence backlog is unchanged.

    Implementation conversation.

  6. rachaelrenk
    added a commit that references this issue on Nov 11, 2026

    docs: strengthen Factories positioning and writing governance (#1012)

    8574ba4

  7. warp-agent-staging commented on Nov 11, 2026

    @warp-agent-staging
    warp-agent-stagingBot
    on Nov 11, 2026 – with Warp Agent Staging
    ContributorAuthor

    Merged docs guidance: #1012, merge 8574ba4.
    Factory configuration remains open under human ownership; this issue stays open until that follow-up is resolved.

    Responding as Docs Factory (V2): Open session · View in factory

  8. rachaelrenk commented on Nov 11, 2026

    @rachaelrenk
    rachaelrenk
    on Nov 11, 2026
    Contributor

    Implementation refresh after #1012 merged:

    • Canonical governance is merged. Public corrections remain in #884 at 06344af8: current main integrated; the original nine-page positioning correction now also applies the approved agent/field formatting to dashboard and GitHub/GitLab label references (12 pages total). Generic roles remain lowercase/unbolded; literal labels and feature-list emphasis are preserved.
    • Examples #3 is updated at c7ea017, preserving prior editorial work and the pinned default-agent files. All 15 current example roots parsed successfully (correcting the earlier count of 16), with no apply-state or behavioral claim. Conventions, 12 tests, and snapshot verification passed.
    • Config #34 is updated at f49856e: examples review no longer inherits docs-only requirements; missing required guidance pauses dependent work. Sixteen proposed judge cases and one less-coached generation task await human calibration. All 43 tests and complete stage-inclusive v1alpha2 parser validation passed. New scorer sampling remains zero and self-improvement off; existing scorer settings are unchanged.
    • Common-skills #116 is updated at 0102d28, with canonical loading and interactive safeguards preserved. Maintained source only; installed copies were not refreshed.

    Docs validation: typecheck (0 errors), 5 heading-variable tests, 151 policy tests, 6 positioning groups, explicit lint comparison over all 12 pages (no introduced findings), and technical-reference checks passed. The same three broken factory-inbox links remain in files unchanged from main. The current local build failed in /_llms-txt/support.txt with a stack overflow under unsupported Node 25; untouched-main reproduction was cancelled before execution, so its origin is not established. Build-dependent TOC/JSON-LD and fresh browser evidence are not complete. Hosted editorial, technical-reference, and CodeQL checks passed; build/deployment checks were still running. The independent review failed before analysis with authentication 401, not an editorial verdict.

    All four existing branches were pushed and descriptions refreshed; no new PR, merge, live apply, paid evaluation, scorer activation, or schedule change. #890 remains untouched and compatible; #876 remains state-only/do-not-merge. Config #32 is still unmerged and owns examples access. Remaining gates: successful build/render verification and independent review, human merges, runtime checkout/access verification, installed-skill refresh after merge, and separately approved calibration/budget/rollout. This is a targeted follow-up, not a repeated whole-corpus audit or proof of improved generated writing.

  9. rachaelrenk commented on Nov 11, 2026

    @rachaelrenk
    rachaelrenk
    on Nov 11, 2026
    Contributor

    CI follow-up for #884 at the same 06344af8 head: hosted Node 22 site build, heading/TOC validation, homepage JSON-LD, and agent-documentation output checks all passed in run 42937190919. The combined job failed later at the three unchanged factory-inbox links, not during the build. The independent-review authentication 401 remains a separate unresolved gate. This supersedes the pending hosted-build status in the preceding update; fresh browser evidence is still not claimed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    factory:docs-factoryLabel associated to the "docs-factory" factoryimprove or update documentationIncorrect, outdated, missing, or unclear documentation contentpriority/mediumOutdated content, confusing instructions, incomplete coveragetriageNeeds human review — remove after triaging

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions