feat(tbd-cli): Update issue prefix convention and require prefix during init#8
Merged
Conversation
…ng init - Change documentation examples from 'bd-' to 'proj-' prefix - Make display.id_prefix required (no default) in ConfigSchema - Update init command to require --prefix option - Update import command to auto-detect prefix from beads issues - Update design document to reflect new prefix requirements - Update tests to use 'tbd' as fallback prefix instead of 'bd' This ensures each project has a meaningful, project-specific prefix rather than defaulting to beads compatibility. When importing from beads, the prefix is automatically detected from the existing issues.
… tests - Update all commands to read display prefix from config.display.id_prefix - Add shared loadDataContext() utility for consistent data loading - Fix tryscript tests to use --prefix=test notation consistently - Replace hard-coded bd-42 examples in setup.ts with generic <id>
- Add prefix configuration to latest validation summary - Update test examples to use --prefix=<name> syntax - Add prefix config row to validation checklist
Update all tryscript tests to use --prefix when calling tbd init, and fix expected output patterns to match the configured prefix: - Tests using --prefix=test expect test- prefix in output - Tests using --prefix=bd expect bd- prefix in output Also update init help output to show the new --prefix option. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Windows CI can have slow cold start times for file I/O. Increased threshold from 100ms to 500ms to account for this variance. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
jlevy
changed the title
jlevy
pushed a commit
that referenced
this pull request
Feb 1, 2026
Key changes: - Use tbd short ID directly as Markform option ID (e.g., `<!-- #proj-a1b2 -->`) - Remove dual-ID system (`#markform_id tbd:issue_id` -> just `#proj-xxxx`) - Update all code examples to reflect simplified format - Add spec_path and child_order_hints from new tbd features - Update open questions #7 and #8 to reflect resolved decisions The simplification makes plan files cleaner and eliminates mapping between separate ID namespaces since tbd short IDs are guaranteed unique and valid as Markform identifiers.
jlevy
pushed a commit
that referenced
this pull request
May 7, 2026
The user pointed out the new Design Principles in the docs-config plan should be cross-referenced and consolidated with the existing tbd-design principles. Three changes: 1. tbd-design.md §1.5 (Design Principles) extended from 6 to 10: - #1 (Simplicity first) extended to spell out "simple things simple, complex things possible". - #3 (Git for sync) extended with the reproducible-from-config contract. - #7 added: Auth is always out-of-band — tbd never holds credentials. - #8 added: Hard cuts on format versions with reliable migration — already practiced for f02→f03; making it an explicit principle. - #9 added: Spec ↔ implementation synchrony via tests. - #10 added: Layered architecture, separable artifacts. These four new principles emerged from the docs-config redesign work but apply tbd-wide. 2. tbd-design.md §1.4 Design Goals: added goal #8 (extensible knowledge subsystem), which links forward to the plan-spec and the docref/ docmap design docs as the authoritative location for that subsystem's design. 3. plan-spec Design Principles intro: now explicitly notes that P1, P5, P6, P7, P8, P9 are restatements/elaborations of tbd-design §1.5 principles, while P2, P3, P4 are docs/config-specific and have no direct system-wide analog. Each restated principle gets an inline "(extends tbd-design §1.5 #N)" cross-reference. tbd-design.md is declared authoritative for system-wide values. This consolidates principles in one foundational location (tbd-design.md) while keeping the docs-config plan readable on its own. https://claude.ai/code/session_01PhbYdWX7DUBpUBVuUesVuP
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR updates the issue ID prefix convention, making the prefix a required project-specific setting rather than a hardcoded default. It also fixes CI failures by updating all tryscript tests to work with the new required
--prefixoption.Closes: #7 (supersedes and includes all changes from PR #7)
Changes
Prefix Convention (from #7)
bd-toproj-prefix to clarify that the prefix is project-specificdisplay.id_prefixa required field (no default) in the ConfigSchematbd initcommand to require--prefix=<name>optiontbd import --from-beadsDocumentation (from #7)
bd-toproj-Code (from #7)
display.id_prefixis now required (no default)initConfig()requires aprefixparameter--prefixoption (required), shows helpful error if omitteddetectBeadsPrefix()to auto-detect prefix from beads issues during importloadDataContext()utilitybd-42examples with generic<id>placeholdersTest Fixes (this PR)
--prefix=testor--prefix=bdintbd initcalls--prefixoptionTest plan
tbd initwithout--prefixshows helpful error messagetbd init --prefix=myprojcreates config with correct prefixtbd import --from-beadsauto-detects prefix from beads issuesbd-prefixes remain in source code🤖 Generated with Claude Code