Skip to content

Run this repository's work through NodeSpace's built-in playbook and the adopted community workflow skills #3712

Open

Description

@malibio

Blocked: waits for a workable sync system. This repository's work stays on GitHub issues and nodespace-docs until then, and its development process (skills, commands, hooks, the agent guide) is not changed before the move. The adapted skills ship in the product first (#3719, #3720, #3722); this issue is where the repository starts using them.

Overview

Make this repository the first real user of NodeSpace's built-in playbook: the seeded schemas (spec, plan, task, decision), skills, queues and Plays (ADR-092, ADR-093, ADR-094). The procedures it runs are the adapted community workflow skills (#3719 and #3720), held as skill nodes in the graph and handed to the agent by NodeSpace, not installed into a harness. Using it ourselves is how we find what the built-in playbook is missing before anyone else does, and whether the rules do anything.

Problem Statement

  • The mandatory startup sequence is prose in startup-sequence.md and the repository's agent instruction file, plus hooks. Nothing records whether the baseline was run, and the sequence cannot serve as the shipped pattern for other projects.
  • The built-in playbook has not been used for real work, on any harness.
  • The task spec rule (ADR-097) now applies only to a task that links a spec. Whether development work here actually starts with an approved spec is unmeasured.

Proposed Solution

Documentation

  • ADR-092 §6 to §9 - the seeded Plays, Ready tasks, the seeded skills and queries, and that installable bundles were removed: the playbook is what a database is seeded with
  • ADR-094 "The shipped workflow" - queues, procedures and standards as skills attached to queries and a project
  • ADR-093 §2 to §6 - how a coding agent receives skills and task context, per harness
  • ADR-072 - a seed is a starting point; an edited aspect is the user's
  • ADR-097 §1, §6 and §7 - the spec rule and what to count
  • Startup sequence, issue workflow, development/overview.md - what moves
  • Updates: development/startup-sequence.md, development/overview.md

Architecture Impact

None. Uses existing primitives (skills attached to nodes, checklist children, saved queries, Plays). No bundle format, playbook type or install mechanism is added (ADR-092 §9 removed those).

Acceptance Criteria

  • The setup skill exists, attached to this repo's project, and is delivered to an agent starting a task
  • A task can carry a "Baseline recorded" checkbox, and the optional Play rejects in_review without it
  • startup-sequence.md points to the skill and no longer duplicates its steps; the startup content in the agent instruction file is absorbed into the graph (skill and project standards), not edited in place
  • The existing check-feature-branch.ts and plan-mode reminder hooks are kept or removed, with the reason written down
  • Real tasks in this repository are taken from Ready tasks, worked with the adapted skills and finished, on at least two harnesses
  • The three counts above are recorded on this issue with what they show
  • Each place the playbook failed or had to be worked around is filed as its own issue, saying which of the four parts it is in (schema, skill, query, Play)
  • Code passes bun run quality:fix

Technical Specifications

Reference Files

  • development/startup-sequence.md and development/issue-workflow.md (nodespace-docs)
  • The repository's agent instruction file (content to absorb into the graph), .claude/settings.json, .claude/hooks/
  • packages/core/src/playbook/core_plays.rs, packages/core/src/services/query_service/core_queries.rs, packages/agent/src/seeds/skills/

Implementation Details

  • The baseline Play is a sketch; whether to reject at in_review or at in_progress is a real choice (the checklist may not exist when the task starts). Try it on a real task first.
  • Keep bun run gh:* and EnterWorktree as repository tooling. Only ordering and recorded state move.
  • Do not embed issue numbers in nodespace-docs (documentation standard).
  • Questions per task is counted by hand for now; nothing in the product records it.

Dependencies

Related Issues

Non-Goals

  • Changing how GitHub issues are tracked
  • Moving or renaming the instruction file: its content is absorbed into the graph and the file is generated from it later
  • Checking an agent's repository writes (ADR-097 records why it is not built)
  • A bundle format, a playbook node type, a marketplace or installing a playbook: the playbook stays the set a database is seeded with
  • Changing the shipped seeds: what using them here shows is wrong is filed separately

Activity

  1. malibio commented on Oct 10, 2026

    @malibio
    CollaboratorAuthor

    Frontend baseline: 324 files / 5873 tests passed

  2. assigned and unassigned on Oct 10, 2026
  3. changed the title [-]Run this repository's startup sequence on NodeSpace[/-] [+]Run this repository's work through NodeSpace's built-in playbook and the adopted community workflow skills[/+] on Oct 11, 2026
  4. malibio commented on Oct 11, 2026

    @malibio
    CollaboratorAuthor

    The trial also uses the triage skill and the waiting-on-a-person pattern from #3722, and the review flow in #3720: a task is reviewed by a session other than the one that implemented it, and the implementing session is kept to address the findings.

  5. malibio commented on Oct 11, 2026

    @malibio
    CollaboratorAuthor

    The backlog comes across with #3734 (open GitHub issues recreated as shaped tasks and specs), and the design record with #3727.

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

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions