@byrde/cursor 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,26 @@
1
+ ---
2
+ alwaysApply: false
3
+ description: Lightweight init fallback that points users to the CLI installer.
4
+ ---
5
+
6
+ ## Purpose
7
+
8
+ This rule no longer runs the old embedded initialization conversation. Its job is only to preserve discoverability when a user reaches for `@init.mdc` directly.
9
+
10
+ ## Behavior
11
+
12
+ 1. **If workflow assets are missing**
13
+ - Instruct the user to run:
14
+ ```bash
15
+ npx @byrde/cursor init
16
+ ```
17
+ - Explain that the CLI installs rules, agents, templates, project config, and starter docs.
18
+
19
+ 2. **If workflow assets are installed but docs are still missing or in template mode**
20
+ - Explain that `.cursor/rules/global.mdc` now handles initialization automatically through the normal `/planner` then `/architect` flow.
21
+ - Point the user back to the regular chat flow instead of starting a separate embedded init conversation here.
22
+
23
+ 3. **Do not run legacy init scaffolding from this rule**
24
+ - No banners
25
+ - No persona handoff script
26
+ - No embedded planning or scaffolding sequence
@@ -0,0 +1,18 @@
1
+ # Project Backlog
2
+
3
+ | Epic | Priority | Task Description | Acceptance Criteria | Status | Prototype | Notes |
4
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
5
+ | **[Epic from Key Features]** | 1000 | [Task Title or User Story] | [Verifiable criteria for completion] | `TODO` | | [Dependencies, context, testability considerations] |
6
+ | **[Epic from Key Features]** | 1000 | [Task Title or User Story] | [Verifiable criteria for completion] | `TODO` | | [Dependencies, context, testability considerations] |
7
+
8
+ ## Column Guide
9
+
10
+ - **Priority**: Lower numbers sort earlier in the backlog (`1` before `2`). Use `1000` as an unprioritized default. In GitHub Project (v2) mode, this mirrors the Project **Priority** field.
11
+ - **Status**: Must follow `TODO` → `In Progress` → `Ready to Test` → `Complete`. In GitHub Project (v2) mode, this mirrors the Project **Status** field.
12
+ - **Epic**: In GitHub mode, epics are represented by **milestones** on issues.
13
+ - **Prototype**: Maintained by prototyping workflow. Leave empty for new tasks. When prototype exists: `prototypes/[slug].[ext]` + brief findings.
14
+ - **Notes**: Include testability considerations for non-trivial verification:
15
+ - If feature involves long-running processes, note start/verify/stop pattern needed
16
+ - If feature requires user interaction for testing, note the handoff scenario
17
+ - If verification is straightforward, no note needed
18
+ - Prefer pointing at the per-feature file under `docs/testability/` (e.g. `010-feature-slug.md`) when verification is non-trivial
@@ -0,0 +1,25 @@
1
+ # Domain-Driven Design (DDD) Strategy
2
+
3
+ ### 1. Ubiquitous Language Glossary
4
+ | Term | Definition | Aliases |
5
+ | :--- | :--- | :--- |
6
+ | **[Term]** | [Definition of the term within this specific domain.] | [Any synonyms or aliases?] |
7
+ | **[Term]** | [Definition of the term within this specific domain.] | [Any synonyms or aliases?] |
8
+
9
+ ### 2. Core Domain and Bounded Context
10
+ * **Core Domain:** The central and most important part of the software's business logic.
11
+ * *[Describe the single, most critical part of your business logic that gives you a competitive advantage.]*
12
+
13
+ * **Bounded Contexts:** The distinct areas of the application with their own models and language.
14
+ * - **[Context Name]:** [Briefly describe the responsibility of this context and the language used within it.]
15
+ * - **[Context Name]:** [Briefly describe the responsibility of this context and the language used within it.]
16
+ * *[Add more contexts as needed]*
17
+
18
+ ### 3. Aggregates
19
+ * A cluster of associated objects that we treat as a single unit for the purpose of data changes. *(Copy and paste the template below for each aggregate you identify).*
20
+
21
+ * **[Aggregate Name] Aggregate**
22
+ * **Aggregate Root:** `[Root Entity Name]`
23
+ * **Entities:** `[List of other entities within the aggregate boundary]`
24
+ * **Value Objects:** `[List of value objects within the aggregate]`
25
+ * **Description:** `[Explain the aggregate's purpose and the business rules (invariants) it enforces.]`
@@ -0,0 +1,38 @@
1
+ # Software Development Project: [Project Name]
2
+
3
+ ## Overview
4
+
5
+ ### 1. Project Name
6
+ * **[Your Project Name]**
7
+
8
+ ### 2. Project Description
9
+ * A brief, high-level summary of the project. What is it? What does it do?
10
+ * *[Enter a one or two-sentence summary of the project's purpose and functionality.]*
11
+
12
+ ### 3. Project Vision
13
+ * The long-term vision and ultimate goal of the project. What impact will it have?
14
+ * *[Describe the ultimate goal and the positive impact the project will have in the long term.]*
15
+
16
+ ### 4. Problem Statement
17
+ * A clear and concise description of the problem this project aims to solve.
18
+ * *[Clearly define the problem, need, or pain point this project is intended to solve.]*
19
+
20
+ ### 5. Target Audience
21
+ * A detailed description of the primary and secondary users of this software.
22
+ * **Primary Audience:** *[Describe the primary user group, including key demographics or characteristics.]*
23
+ * **Secondary Audience:** *[Describe any secondary user groups that will also use or be impacted by the software.]*
24
+
25
+ ### 6. Key Features
26
+ * A list of the most important features and functionalities of the software. These will be considered the epics when filling out the backlog, take special care filling them out.
27
+ * - **[Feature Name]:** [Brief description of the feature.]
28
+ * - **[Feature Name]:** [Brief description of the feature.]
29
+ * - **[Feature Name]:** [Brief description of the feature.]
30
+ * *[Add more features as needed]*
31
+
32
+ ### 7. Technology Stack
33
+ * A list of the technologies, frameworks, and platforms that will be used to build the project.
34
+ * **Frontend:** *[e.g., React, Vue, Angular, SvelteKit, iOS/Swift, Android/Kotlin]*
35
+ * **Backend:** *[e.g., Node.js, Python/Django, Go, Rust, Java/Spring]*
36
+ * **Database:** *[e.g., PostgreSQL, MongoDB, MySQL, SQLite, Redis]*
37
+ * **Authentication:** *[e.g., OAuth 2.0, JWT, Auth0, NextAuth, Firebase Auth]*
38
+ * **Deployment:** *[e.g., Docker, Vercel, AWS, Google Cloud, Azure]*
@@ -0,0 +1,102 @@
1
+ # Testability index
2
+
3
+ Record how AI verifies each feature using shell commands. Prefer **one markdown file per feature** in this directory.
4
+
5
+ In repositories that use Byrde’s GitHub Actions layout, the mandatory baseline is the **`build-and-test`** job. **`architect-review`** and **`feature-verification`** are additional visible checks that always run lightweight documentation verification and are not release gates.
6
+
7
+ ## Naming
8
+
9
+ Use `{FEATURE_NUMBER}-{BRIEF_DESCRIPTION}.md` (for example `001-cli-auth.md`). `FEATURE_NUMBER` is a stable project-local identifier (often zero-padded or backlog-derived). `BRIEF_DESCRIPTION` is a short kebab-case slug.
10
+
11
+ Optionally keep this `README.md` as a short index that links to active feature files.
12
+
13
+ ## What to capture (per feature file)
14
+
15
+ Use the sections below as a checklist; omit sections that do not apply.
16
+
17
+ ### Quick entry
18
+
19
+ | Feature | Verification command | Type |
20
+ | :--- | :--- | :--- |
21
+ | [Feature name] | `[shell command]` | Standard |
22
+ | [Feature name] | See Long-Running section below | Long-running |
23
+ | [Feature name] | See User-in-the-loop section below | User action required |
24
+
25
+ ## Standard verifications
26
+
27
+ ### [Feature name]
28
+
29
+ ```bash
30
+ # Command to verify feature
31
+ [command with arguments]
32
+ ```
33
+
34
+ **Expected output:** [What success looks like]
35
+
36
+ ## Long-running process verifications
37
+
38
+ For services, servers, or processes that do not exit immediately.
39
+
40
+ ### [Feature name]
41
+
42
+ **Start:**
43
+
44
+ ```bash
45
+ timeout 30 ./start-service &
46
+ ```
47
+
48
+ **Verify:**
49
+
50
+ ```bash
51
+ curl -f http://localhost:8080/health
52
+ ```
53
+
54
+ **Stop:**
55
+
56
+ ```bash
57
+ kill %1
58
+ ```
59
+
60
+ **Notes:** [Special considerations]
61
+
62
+ ## User-in-the-loop verifications
63
+
64
+ For OAuth, hardware, visual checks, etc.
65
+
66
+ ### [Feature name]
67
+
68
+ **AI setup:**
69
+
70
+ ```bash
71
+ [setup commands]
72
+ ```
73
+
74
+ **User action required:**
75
+
76
+ > [What the user must do]
77
+
78
+ **AI verification** (after the user confirms):
79
+
80
+ ```bash
81
+ [verification commands]
82
+ ```
83
+
84
+ **Expected result:** [Success criteria]
85
+
86
+ ## Environment setup
87
+
88
+ ### Prerequisites
89
+
90
+ - [Dependency]
91
+
92
+ ### Before testing
93
+
94
+ ```bash
95
+ [setup]
96
+ ```
97
+
98
+ ### Cleanup
99
+
100
+ ```bash
101
+ [cleanup]
102
+ ```