Skip to Content
DocsFeaturesStory Workspace

Story Workspace

The Story Workspace is where AIDEN turns a story into something concrete.

Today, one of its most important surfaces is the spec editor — especially for teams that want stronger planning, clearer requirements, and better execution from AI.


Why the spec editor matters

A good story is not just a title on a board. It needs a clear target.

The spec editor is where you shape that target into something useful:

  • clearer scope
  • sharper requirements
  • cleaner implementation direction
  • better review criteria
  • better inputs for AI execution

If the spec is vague, the output usually drifts. If the spec is strong, AIDEN becomes dramatically more reliable.


Writing specs in MDX

The spec editor is especially powerful because it supports MDX-style content.

That means your spec can hold much more than plain paragraphs. You can write rich, implementation-ready documentation with things like:

  • structured sections
  • code blocks
  • examples
  • notes and callouts
  • side-by-side thinking between UX, product, and implementation details

This makes the spec feel closer to a real working document than a throwaway note.


What this unlocks for AI

AIDEN can use a strong spec as real working context.

That is where the product starts to feel much more serious than generic prompt-driven coding. A richer spec gives AI better material to work from:

  • clearer goals
  • clearer constraints
  • concrete examples
  • realistic acceptance criteria
  • better implementation hints

In practice, that means AI can use the full potential of the spec to generate much stronger plans and much stronger execution.


What a strong spec can include

Inside the spec editor, a great story spec might contain:

  • product summary
  • user problem
  • scope and out-of-scope rules
  • UX direction
  • acceptance criteria
  • implementation notes
  • code examples
  • copy options
  • edge cases

That combination is what helps AIDEN produce top-notch specs instead of shallow planning notes.


Best use cases

The Story Workspace is especially strong when you want to:

  • turn a rough idea into a serious spec
  • create implementation-ready planning documents
  • compare several approaches in one place
  • give AI better context before execution starts
  • keep planning and doing tightly connected

Best practice

Treat the spec editor as a real working surface, not a formality.

Use MDX to make the spec richer. Add examples. Make the scope explicit. Show what good looks like.

The better the spec, the better AIDEN can perform.