Repository navigation
docs: match factory agents and skills pages to the seeded defaults (audit 1/5) - #853
Draft
hongyi-chen wants to merge 9 commits into
Draft
hongyi-chen wants to merge 9 commits into
hongyi-chen wants to merge 9 commits into
Conversation
Reshape the factories overview from a launch-post structure into a technical overview: a concrete definition up front, one short section per part of a factory, sizing guidance, and related pages. Removes the "Who benefits", "What you get", product-table, and "Key terms" sections and the undefined "delivery policy" coinage. The #sizing-a-factory anchor that three pages link to is preserved. Aligns the opening definition on how-factories-work and the docs homepage with the overview, trims the diagram legend, cuts the salesy self-improvement framing, and adds the missing Related pages section. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
…w-copy # Conflicts: # src/content/docs/factories/how-factories-work.mdx # src/content/docs/factories/index.mdx # src/content/docs/index.mdx
Tighten the opening (drop "tools your team already uses"), make the component headings parallel, say "repeated failures" consistently, and note that benchmarks now compare harnesses as well as models and runners per #841. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
Add Microsoft Teams and Azure DevOps to the how-factories-work work sources legend so it matches the overview, and drop the restated consequence clause from the overview's Execution section in favor of naming what the infrastructure page covers. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
Same treatment as the factories overview: a concrete opener, three short lists of what Enterprise adds (administration, security and compliance, shared team configuration), role-based entry points, and related pages. Removes the "Who Warp Enterprise is for", "What this section covers", "Why enterprises choose Warp", and "Support and resources" sections and the marketing adjectives. Every retained claim was checked against the enterprise page it links to. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
This reverts commit ff03ffb.
Shorten the lead to two sentences, keep the CTA cards directly under it, and open a "What a factory does" section for the foreman, example, and human-checkpoint detail so the body is not an unbroken block of prose before the first H2. Rewrite the description so it stops repeating the lead paragraph it renders next to. Co-Authored-By: Warp <agent@warp.dev> Co-Authored-By: Oz <oz-agent@warp.dev>
Part 1 of 5 of the Warp Factories docs audit, split out of #852. Co-Authored-By: Warp <agent@warp.dev>
hongyi-chen
added
the
warpy-factory
Warp Agent Staging
Collaborator
Author
|
This PR was generated with Warp. Comment   |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Part 1 of 5 of the Warp Factories docs audit (split out of #852). Fixes the two pages whose claims had drifted furthest from the product: what skills a new factory ships with, and whether setup picks models.
Changes
factory-skills.mdxwarp-serverseeds:code-quality,code-review,ui-verification, the connected code host's skill (github,gitlab, orazuredevops),slackormicrosoft-teams, andlinearorjira, all written as files under the definition'sskills/directory and available to every agent, including custom ones. The page previously said every default agent gets a GitHub skill, the foreman a Slack skill, and that these "aren't files in your definition".read_skillattribution section, which also live onapi-and-sdk/index.mdx; the page now links there.factory-agents.mdxfactory-skills.mdx.run_agents/agent_identity_uidsection is rewritten for a human reader (it read as instructions to the foreman), and the automations paragraph that sat under it gets its own heading.## Related pagessection is added.platform/orchestration/index.mdxfactory-agents.mdxanchor.Content design plan
Audience and JTBD: A team lead reading how the default agents work before customizing them.
Problem: The skills claims contradicted the shipped definition, and the dispatch section was written for the agent rather than the reader.
Goals: Both pages describe the seeded definition as it ships; skills are explained once.
Content type: Existing feature pages; no new pages.
High-impact scenarios: Covers built-in skills, default models, custom agents, and dispatch. Excludes the bundled-skill catalog (stays on the API page).
Unverified claims
None.
Documentation risk
Risk: engineering-review-required
Rationale: Changes product claims about built-in factory skills and default agent models. The seeded skill directory and its factory-wide placement were confirmed in logic/factory_source_export.go and logic/factoryfile/path.go at the same commit.
Source files consulted: warp-server/logic/factorysource/defaults/skills.go@cf7e9149d422, seeds.go@cf7e9149d422 (same directory)
Engineering review status: pending
Docs override: none
Validation
npm run build,check_links.py --internal-only(0 broken), andstyle_lint.pywere run on the combined audit branch that these files were split from.Plans:
Co-Authored-By: Warp agent@warp.dev