Skip to content

docs(readme): Correct old names, stale facts and the default API host - #3

Merged
johnxie merged 1 commit into
mainfrom
docs/correct-stale-names
Nov 18, 2026
Merged

johnxie merged 1 commit into
mainfrom
docs/correct-stale-names

Conversation

@johnxie

@johnxie johnxie commented Nov 18, 2026

Copy link
Copy Markdown
Member

Before

  • The README used internal names and old names for the Workspace DNA layers and the app engine.
  • It said that a workspace has four types of DNA.
  • It called the app gallery by an old name.
  • npm run import failed with a 404 on the default API host. The bare taskade.com host redirects, and the redirect turns the POST into a GET.
  • The scripts told users that workspace URLs use /ws/<id>.
  • The fork step did not clone the fork, so npm install ran in the wrong folder.
  • The hosted MCP link opened the server endpoint, which returns 401 in a browser.

After

  • Workspace DNA has three parts: Memory, Intelligence and Execution. The app interface sits on top of them.
  • The text says "Taskade Genesis" and "Taskade App Factory".
  • The default API host is https://www.taskade.com. With a test token, import now reaches the API and returns 401, not 404.
  • Workspace URLs use /spaces/<id>.
  • The fork step uses --clone and cd.
  • The repo tree lists export.ts. The scripts table says that bundle export needs the Pro plan or higher and links the pricing page.
  • The MCP link opens the hosted MCP docs page and shows the server URL.
  • The sample project, the roadmap item, the manifest description and the sample app labels use the same names.

Links checked

All return 200: /create, /ai/apps, /ai/agents, /apps, /pricing, /docs/mcp/hosted-mcp, /api/documentation/v1, /settings/api, and github.com/taskade/mcp. The https://www.taskade.com/mcp endpoint returns 401 to a browser, as expected.

How to check

  1. Run npm install and npm run build. All validations pass.
  2. Run TASKADE_API_TOKEN=tskdp_x TASKADE_WORKSPACE_ID=x npm run import. The result is a 401, not a 404.

- Workspace DNA has three parts: Memory, Intelligence and Execution
- Replace internal and old names with plain words and "Taskade Genesis"
- Name the app gallery Taskade App Factory
- Default TASKADE_API_URL to https://www.taskade.com: the bare host
  redirects, and the redirect turns the import POST into a GET (404)
- Workspace URLs use /spaces/<id>, not /ws/<id>
- Add --clone to the fork step, list export.ts, note the export plan
- Link the hosted MCP docs page instead of the endpoint (401 in a browser)
Copilot AI lite review requested due to automatic review settings November 18, 2026 22:45

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟡 Changes recommended

README.md contains an active documentation issue that could mislead users about the API shape of individual source files versus the assembled bundle.

1 open issue
What changed in this PR

Updates the Taskade Genesis sample app documentation, scripts, and labels to use current product terminology, canonical API and workspace URLs, and clearer import/export guidance.

Changes:

  • Renames Workspace DNA concepts and app-gallery references to current terminology.
  • Uses https://www.taskade.com as the default API host and updates workspace URL guidance.
  • Improves setup documentation, repository structure, export-plan details, hosted MCP documentation, and sample content labels.
File Description
scripts/​import.ts Updates the default API host and workspace URL guidance for imports.
scripts/​export.ts Updates the default API host and workspace URL guidance for exports.
scripts/​assemble.ts Refreshes the app filesystem description to use Taskade Genesis terminology.
README.md Revises Workspace DNA terminology, setup instructions, links, API details, and repository documentation.
projects/​roadmap.json Renames the community gallery roadmap destination to Taskade App Factory.
projects/​getting-started.json Updates the sample project's Genesis terminology and Workspace DNA layer names.
manifest.json Updates the sample app description to use Taskade Genesis terminology.
apps/​hello-world.json Updates the sample app description and badge labels.

Review effort: Lite

Comment thread README.md
| **Interface** | `apps/` | Taskade Genesis app UI — React components that the app engine runs |

This repo contains one JSON file per DNA item — the same format that Taskade uses internally. No build toolchain required to understand or edit.
This repo contains one JSON file per DNA item — the same format that the Taskade bundle import and export API uses. No build toolchain required to understand or edit.
@johnxie
johnxie merged commit 361ec0d into main Nov 18, 2026
5 checks passed
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.

2 participants