Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ When executing terminal commands (using `run_in_terminal` or similar tools):

## Other instructions

| Tech | Instruction file |
|------|------------------|
| Tech | Instruction file |
|------------|-------------------------------------------------------------|
| PowerShell | [pwsh.instructions.md](./instructions/pwsh.instructions.md) |
| Markdown | [md.instructions.md](./instructions/md.instructions.md) |
| Markdown | [md.instructions.md](./instructions/md.instructions.md) |
2 changes: 2 additions & 0 deletions .github/linters/.markdown-lint.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ MD026:
MD029: false # Ordered list item prefix
MD033: false # Allow inline HTML
MD036: false # Emphasis used instead of a heading
MD060:
style: "leading" # Table column style (leading avoids emoji width issues)

#################
# Rules by tags #
Expand Down
6 changes: 3 additions & 3 deletions .github/prompts/constitution.prompt.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,9 @@ Two operating modes:

Replacement Analysis Table (when overlap detected):

| Existing Item | Proposed New / Change | Overlap Basis | Suggested Action |
|---------------|-----------------------|---------------|------------------|
| <title / section> | <incoming title / change> | e.g. semantic similarity, scope duplication | Replace / Merge / Keep Both |
| Existing Item | Proposed New / Change | Overlap Basis | Suggested Action |
|---------------------|---------------------------|----------------------------------------------|----------------------------|
| <title / section> | <incoming title / change> | e.g. semantic similarity, scope duplication | Replace / Merge / Keep Both |

Heuristics for overlap:
- Title similarity score (case-insensitive) >= 0.6 (rough string similarity) OR
Expand Down
16 changes: 8 additions & 8 deletions .github/prompts/plan.prompt.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,14 +102,14 @@ Given the implementation details provided as an argument, do this:
- **Use the same title for the PR**: The PR title must match the issue title exactly
- If unable to retrieve the issue title, determine the PR type and icon based on the changes:

| Type of change | Icon | Label |
|-|-|-|
| Docs | 📖 | Docs |
| Fix | 🪲 | Fix, Patch |
| Security fix | ⚠️ | Fix |
| Patch | 🩹 | Patch |
| Feature | 🚀 | Minor |
| Breaking change | 🌟 | Major |
| Type of change | Icon | Label |
| --------------- | ---- | ---------- |
| Docs | 📖 | Docs |
| Fix | 🪲 | Fix, Patch |
| Security fix | ⚠️ | Fix |
| Patch | 🩹 | Patch |
| Feature | 🚀 | Minor |
| Breaking change | 🌟 | Major |

- Fallback PR title format (if issue title unavailable): `<Icon> [Type of change]: <Short description>`
- Create PR description:
Expand Down
14 changes: 7 additions & 7 deletions .github/prompts/pr.prompt.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ $ARGUMENTS

## Supported Change Types

| Type | Icon | Labels | Description |
|------|------|--------|-------------|
| Major | 🌟 | `Major` | Breaking changes that affect compatibility |
| Minor | 🚀 | `Minor` | New features or enhancements |
| Patch | 🩹 | `Patch` | Small fixes or improvements |
| Fix | 🪲 | `Fix`, `Patch` | Bugfixes |
| Docs | 📖 | `Docs` | Documentation changes only |
| Type | Icon | Labels | Description |
| ----- | ---- | -------------- | ------------------------------------------ |
| Major | 🌟 | `Major` | Breaking changes that affect compatibility |
| Minor | 🚀 | `Minor` | New features or enhancements |
| Patch | 🩹 | `Patch` | Small fixes or improvements |
| Fix | 🪲 | `Fix`, `Patch` | Bugfixes |
| Docs | 📖 | `Docs` | Documentation changes only |

## Execution Steps

Expand Down
30 changes: 15 additions & 15 deletions .specify/memory/constitution.md
Original file line number Diff line number Diff line change
Expand Up @@ -495,21 +495,21 @@ The Process-PSModule workflow uses **dynamic conditions** to determine job execu

### Publishing Behavior Examples

| PR State | Labels | Build/Test | Publish-Module | Publish-Site | Version |
|----------|--------|------------|----------------|--------------|---------|
| Opened | `minor` | ✅ Yes | ❌ No | ❌ No | N/A (not published) |
| Opened | `prerelease` | ✅ Yes | ✅ Yes (prerelease) | ❌ No | `1.3.0-branchname001` |
| Opened | `prerelease`, `minor` | ✅ Yes | ✅ Yes (prerelease) | ❌ No | `1.3.0-branchname001` |
| Synchronized | `major` | ✅ Yes | ❌ No | ❌ No | N/A (not published) |
| Synchronized | `prerelease` | ✅ Yes | ✅ Yes (prerelease) | ❌ No | `1.3.0-branchname002` |
| Merged | `minor` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `1.3.0` |
| Merged | `major` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `2.0.0` |
| Merged | `patch` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `1.2.4` |
| Merged | (no label) | ✅ Yes | ✅ Yes (if AutoPatching) | ✅ Yes | `1.2.4` (patch) |
| Merged | `NoRelease` | ✅ Yes | ❌ No | ❌ No | N/A (skipped) |
| Merged | `prerelease`, `minor` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `1.3.0` (prerelease ignored) |
| Scheduled (cron) | N/A | ✅ Yes | ❌ No | ❌ No | N/A (validation only) |
| Manual (workflow_dispatch) | N/A | ✅ Yes | ❌ No | ❌ No | N/A (validation only) |
| PR State | Labels | Build/Test | Publish-Module | Publish-Site | Version |
| -------------------------- | --------------------- | ---------- | ------------------------ | ------------ | ---------------------------- |
| Opened | `minor` | ✅ Yes | ❌ No | ❌ No | N/A (not published) |
| Opened | `prerelease` | ✅ Yes | ✅ Yes (prerelease) | ❌ No | `1.3.0-branchname001` |
| Opened | `prerelease`, `minor` | ✅ Yes | ✅ Yes (prerelease) | ❌ No | `1.3.0-branchname001` |
| Synchronized | `major` | ✅ Yes | ❌ No | ❌ No | N/A (not published) |
| Synchronized | `prerelease` | ✅ Yes | ✅ Yes (prerelease) | ❌ No | `1.3.0-branchname002` |
| Merged | `minor` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `1.3.0` |
| Merged | `major` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `2.0.0` |
| Merged | `patch` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `1.2.4` |
| Merged | (no label) | ✅ Yes | ✅ Yes (if AutoPatching) | ✅ Yes | `1.2.4` (patch) |
| Merged | `NoRelease` | ✅ Yes | ❌ No | ❌ No | N/A (skipped) |
| Merged | `prerelease`, `minor` | ✅ Yes | ✅ Yes (normal) | ✅ Yes | `1.3.0` (prerelease ignored) |
| Scheduled (cron) | N/A | ✅ Yes | ❌ No | ❌ No | N/A (validation only) |
| Manual (workflow_dispatch) | N/A | ✅ Yes | ❌ No | ❌ No | N/A (validation only) |

### Version Calculation Process

Expand Down
30 changes: 15 additions & 15 deletions .specify/templates/plan-template.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,17 +35,17 @@

## Technical Context

| Aspect | Details |
|--------|---------|
| **Language/Version** | [e.g., Python 3.11, Swift 5.9, Rust 1.75 or NEEDS CLARIFICATION] |
| **Primary Dependencies** | [e.g., FastAPI, UIKit, LLVM or NEEDS CLARIFICATION] |
| **Storage** | [if applicable, e.g., PostgreSQL, CoreData, files or N/A] |
| **Testing** | [e.g., pytest, XCTest, cargo test or NEEDS CLARIFICATION] |
| **Target Platform** | [e.g., Linux server, iOS 15+, Wasm or NEEDS CLARIFICATION] |
| **Project Type** | [single/web/mobile - determines source structure] |
| **Performance Goals** | [domain-specific, e.g., 1000 req/s, 10k lines/sec, 60 fps or NEEDS CLARIFICATION] |
| **Constraints** | [domain-specific, e.g., <200ms p95, <100MB memory, offline-capable or NEEDS CLARIFICATION] |
| **Scale/Scope** | [domain-specific, e.g., 10k users, 1M LOC, 50 screens or NEEDS CLARIFICATION] |
| Aspect | Details |
| ------------------------ | ------------------------------------------------------------------------------------------ |
| **Language/Version** | [e.g., Python 3.11, Swift 5.9, Rust 1.75 or NEEDS CLARIFICATION] |
| **Primary Dependencies** | [e.g., FastAPI, UIKit, LLVM or NEEDS CLARIFICATION] |
| **Storage** | [if applicable, e.g., PostgreSQL, CoreData, files or N/A] |
| **Testing** | [e.g., pytest, XCTest, cargo test or NEEDS CLARIFICATION] |
| **Target Platform** | [e.g., Linux server, iOS 15+, Wasm or NEEDS CLARIFICATION] |
| **Project Type** | [single/web/mobile - determines source structure] |
| **Performance Goals** | [domain-specific, e.g., 1000 req/s, 10k lines/sec, 60 fps or NEEDS CLARIFICATION] |
| **Constraints** | [domain-specific, e.g., <200ms p95, <100MB memory, offline-capable or NEEDS CLARIFICATION] |
| **Scale/Scope** | [domain-specific, e.g., 10k users, 1M LOC, 50 screens or NEEDS CLARIFICATION] |

## Constitution Check

Expand Down Expand Up @@ -243,10 +243,10 @@ directories captured above]

*Fill ONLY if Constitution Check has violations that must be justified*

| Violation | Why Needed | Simpler Alternative Rejected Because |
|-----------|------------|-------------------------------------|
| [e.g., 4th project] | [current need] | [why 3 projects insufficient] |
| [e.g., Repository pattern] | [specific problem] | [why direct DB access insufficient] |
| Violation | Why Needed | Simpler Alternative Rejected Because |
| -------------------------- | ------------------ | ------------------------------------ |
| [e.g., 4th project] | [current need] | [why 3 projects insufficient] |
| [e.g., Repository pattern] | [specific problem] | [why direct DB access insufficient] |

## Progress Tracking

Expand Down
62 changes: 31 additions & 31 deletions .specify/templates/spec-template.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,53 +20,53 @@

### Functional Requirements

| ID | Requirement |
|----|-------------|
| **FR-001** | System MUST [specific capability, e.g., "allow users to create accounts"] |
| **FR-002** | System MUST [specific capability, e.g., "validate email addresses"] |
| **FR-003** | Users MUST be able to [key interaction, e.g., "reset their password"] |
| **FR-004** | System MUST [data requirement, e.g., "persist user preferences"] |
| **FR-005** | System MUST [behavior, e.g., "log all security events"] |
| ID | Requirement |
| ---------- | ----------------------------------------------------------------------------------------------------------------- |
| **FR-001** | System MUST [specific capability, e.g., "allow users to create accounts"] |
| **FR-002** | System MUST [specific capability, e.g., "validate email addresses"] |
| **FR-003** | Users MUST be able to [key interaction, e.g., "reset their password"] |
| **FR-004** | System MUST [data requirement, e.g., "persist user preferences"] |
| **FR-005** | System MUST [behavior, e.g., "log all security events"] |
| **FR-006** | System MUST authenticate users via [NEEDS CLARIFICATION: auth method not specified - email/password, SSO, OAuth?] |
| **FR-007** | System MUST retain user data for [NEEDS CLARIFICATION: retention period not specified] |
| **FR-007** | System MUST retain user data for [NEEDS CLARIFICATION: retention period not specified] |

### Non-Functional Requirements

| ID | Requirement |
|----|-------------|
| **NFR-001** | System MUST respond within [specific time, e.g., "500ms for 95th percentile"] |
| **NFR-002** | System MUST handle [specific load, e.g., "1000 concurrent users"] |
| **NFR-003** | System MUST maintain [availability target, e.g., "99.9% uptime"] |
| **NFR-004** | System MUST scale to [capacity limit, e.g., "10,000 transactions per second"] |
| **NFR-005** | System MUST recover within [time period, e.g., "5 minutes after failure"] |
| ID | Requirement |
| ----------- | ------------------------------------------------------------------------------------------------------------ |
| **NFR-001** | System MUST respond within [specific time, e.g., "500ms for 95th percentile"] |
| **NFR-002** | System MUST handle [specific load, e.g., "1000 concurrent users"] |
| **NFR-003** | System MUST maintain [availability target, e.g., "99.9% uptime"] |
| **NFR-004** | System MUST scale to [capacity limit, e.g., "10,000 transactions per second"] |
| **NFR-005** | System MUST recover within [time period, e.g., "5 minutes after failure"] |
| **NFR-006** | System MUST encrypt data [NEEDS CLARIFICATION: encryption scope not specified - at rest, in transit, both?] |
| **NFR-007** | System MUST maintain audit logs for [NEEDS CLARIFICATION: retention period not specified] |
| **NFR-007** | System MUST maintain audit logs for [NEEDS CLARIFICATION: retention period not specified] |

### Quality Attributes Addressed

| Attribute | Target Metric |
|-----------|---------------|
| **Performance** | [e.g., "Response time < 200ms", "Throughput > 5000 TPS"] |
| **Scalability** | [e.g., "Support 100,000 concurrent users", "Linear scaling to 10 nodes"] |
| **Availability** | [e.g., "99.95% uptime", "Max 4 hours downtime per year"] |
| **Reliability** | [e.g., "MTBF > 720 hours", "Error rate < 0.01%"] |
| **Security** | [e.g., "OWASP Top 10 compliant", "SOC 2 Type II certified"] |
| **Maintainability** | [e.g., "Code coverage > 80%", "Cyclomatic complexity < 10"] |
| **Usability** | [e.g., "Task completion time < 2 minutes", "User satisfaction > 4.5/5"] |
| Attribute | Target Metric |
| ------------------- | ------------------------------------------------------------------------- |
| **Performance** | [e.g., "Response time < 200ms", "Throughput > 5000 TPS"] |
| **Scalability** | [e.g., "Support 100,000 concurrent users", "Linear scaling to 10 nodes"] |
| **Availability** | [e.g., "99.95% uptime", "Max 4 hours downtime per year"] |
| **Reliability** | [e.g., "MTBF > 720 hours", "Error rate < 0.01%"] |
| **Security** | [e.g., "OWASP Top 10 compliant", "SOC 2 Type II certified"] |
| **Maintainability** | [e.g., "Code coverage > 80%", "Cyclomatic complexity < 10"] |
| **Usability** | [e.g., "Task completion time < 2 minutes", "User satisfaction > 4.5/5"] |

### Constraints *(include if applicable)*

| Constraint | Description |
|------------|-------------|
| Constraint | Description |
| ------------------ | --------------------------------------------------------------------- |
| **[Constraint 1]** | [Limitation or restriction, e.g., "Must run on Windows Server 2019+"] |
| **[Constraint 2]** | [Compliance requirement, e.g., "Must comply with GDPR"] |
| **[Constraint 2]** | [Compliance requirement, e.g., "Must comply with GDPR"] |

### Key Entities *(include if feature involves data)*

| Entity | Description |
|--------|-------------|
| Entity | Description |
| -------------- | ----------------------------------------------------------- |
| **[Entity 1]** | [What it represents, key attributes without implementation] |
| **[Entity 2]** | [What it represents, relationships to other entities] |
| **[Entity 2]** | [What it represents, relationships to other entities] |

---

Expand Down
Loading
Loading