Skip to main content
Artifacts are durable documents or outputs inside a Task. They preserve important context so it does not disappear into a chat transcript. The Artifacts panel shows the Task’s artifact tree:
  • Spec
  • Ticket
  • Story
  • Review

​
Artifact Types

Artifact typeRoleStatusAssignee
SpecCaptures goals, requirements, constraints, decisions, and plan context.NoNo
TicketTracks implementation work, what needs to change, and how to verify it.YesYes
StoryOrganizes a user journey, workflow slice, or larger outcome that may span multiple implementation steps.YesYes
ReviewCaptures review findings, critique, decisions, and follow-ups.NoNo
Specs and reviews are shared context. Tickets and stories are work-tracking artifacts.

​
Hierarchy

Artifacts can be arranged in a parent-child hierarchy. This keeps related work grouped inside the Task. The common shape is: 
Task
└─ Spec
   ├─ Ticket
   ├─ Story
   └─ Review
Use hierarchy to keep planning context close to implementation and review context. For example, a spec can hold the tickets that implement it, and a review can sit next to the work it evaluates. Deleting a parent artifact also deletes the artifacts nested underneath it, so check the hierarchy before removing a spec or story with children. Nested chats and terminal agents are not deleted with that artifact subtree; they move up to the parent level.

​
Status

Tickets and stories use three status values:
StatusMeaning
TodoWork exists but has not started.
In ProgressWork is currently active.
DoneWork is complete.
Specs and reviews do not have status because they are not implementation units.

​
Assignees

Tickets and stories can have assignees. An assignee marks who is responsible for that piece of work. Specs and reviews are usually shared context rather than assigned work items.

​
Controls

The panel supports:
  • filtering by artifact type
  • filtering by read state
  • filtering tickets and stories by status
  • sorting by Last Updated, Date Created, or Name
  • creating specs, tickets, and stories from the panel
  • renaming, deleting, and moving artifacts

​
Working With Artifacts

ActionWhat happens
CreateAdds a new spec, ticket, story, or review to the Task. New tickets and stories start as Todo.
RenameChanges the artifact title shown in the sidebar, tab, and artifact references.
MoveDrag an artifact in the sidebar to change its parent.
Change statusUpdates a ticket or story between Todo, In Progress, and Done.
DeleteDeletes the selected artifact and its nested artifact children.
CommentAdds a thread to selected text inside an artifact.

​
Comments

Artifacts support anchored comment threads. Select text in an artifact, add a comment, reply in the thread, and resolve it when the discussion is complete. Comments are useful for review findings, unresolved decisions, and collaboration notes that should stay attached to the exact text they refer to.

​
Storage

Artifacts are stored as markdown documents on disk and synchronized through Traycer’s live document layer when sync is active. The markdown file keeps the artifact type, title, and status metadata with the body content.

​
Modes

Regular Mode is direct coding-agent work. It can still produce artifacts, but artifact creation is explicit or occasional. Epic Mode is Traycer’s structured planning layer. Artifacts are first-class there: specs, tickets, stories, and reviews are expected parts of the workflow.