Skip to content

add a comprehensive diagram to thirdshift.app demonstrating the process of thirdshift #88

New issue
New issue
Closed
#789
Closed
add a comprehensive diagram to thirdshift.app demonstrating the process of thirdshift#88
#789
Labels
enhancementNew feature or request

Description

@JacobStephens2
JacobStephens2
opened on Sep 27, 2026

add a page to thirdshift.app which uses diagrams (maybe mermaid for example) and whatever else to explain to an engineer how thirdshift works

Goal: to explain thirdshift in the order that the engineer needs to learn about thirdshift in order to understand its process, which would help give them confidence in using it. So as they scroll down the page, it should explain and build on and communicate additional concepts, but starting at the top of the page with the first things they need to know. Possibly use a garden metaphor to explain, or just go more with the technical details they'll need to know, such as worktree creation and starting agents in that worktree for example.

Activity

  1. JacobStephens2
    changed the title [-]add a diagram to thirdshift.app demonstrating the process of thirdshift[/-] [+]add a comprehensive diagram to thirdshift.app demonstrating the process of thirdshift[/+] on Sep 27, 2026

  2. JacobStephens2 commented on Oct 17, 2026

    @JacobStephens2
    JacobStephens2
    on Oct 17, 2026
    OwnerAuthor

    This was generated by AI during triage.

    Triage Notes

    What we've established so far:

    • The site already has a “How a Run works” diagram and a floor plan covering the factory's workflows.
    • This issue asks for a more comprehensive diagram but does not identify what those diagrams leave unexplained.

    What we still need from you (@JacobStephens2):

    • Which missing path should the diagram explain: the Day shift to Tickets handoff, Spec dependency/parallel execution, the Delivery Repair loop, or a different specific path?
    • Should this extend an existing diagram or become a separate overview?
  3. JacobStephens2
    added
    enhancementNew feature or request
    needs-infoWaiting on reporter for more information
    ready-for-agentFully specified, ready for an AFK agent
    in-progressA Claim: thirdshift has taken this issue
    and removed
    needs-infoWaiting on reporter for more information
    ready-for-agentFully specified, ready for an AFK agent
    on Oct 17, 2026
  4. JacobStephens2
    closed this as completedin #789on Oct 19, 2026
  5. JacobStephens2
    removed
    in-progressA Claim: thirdshift has taken this issue
    on Oct 19, 2026
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

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions