Skip to content

Commit 6d6f5a3

Browse files
fix(constitution): update workflow requirements for git credential handling and repository depth
1 parent 7e3a3d8 commit 6d6f5a3

File tree

1 file changed

+12
-7
lines changed

1 file changed

+12
-7
lines changed

.specify/memory/constitution.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -622,6 +622,8 @@ jobs:
622622
- All workflow YAML MUST be valid and pass linting
623623
- Action scripts MUST be testable and maintainable
624624
- Inline code in workflows SHOULD be avoided; extract to action scripts
625+
- **Git credential handling**: Workflows MUST use `persist-credentials: false` for checkout actions to prevent credential leakage
626+
- **Repository depth**: Workflows SHOULD use `fetch-depth: 0` for full git history when needed for versioning or changelog generation
625627

626628
### Documentation
627629

@@ -641,9 +643,9 @@ jobs:
641643
- `macos-latest` (macOS)
642644
- BeforeAll/AfterAll setup and teardown scripts MUST be supported for test environments
643645
- Test matrices MUST be configurable via repository settings
644-
- **CI validation workflow** (`.github/workflows/ci.yml`) MUST be maintained for integration testing
645-
- **Production workflow** (`.github/workflows/workflow.yml`) is the primary consumer-facing workflow
646-
- Consuming repositories SHOULD use CI workflow for nightly regression testing
646+
- **CI validation workflows** (`.github/workflows/Workflow-Test-*.yml`) MUST be maintained for integration testing
647+
- **Unified production workflow** (`.github/workflows/workflow.yml`) is the primary consumer-facing workflow
648+
- Consuming repositories SHOULD use CI validation workflows for nightly regression testing
647649

648650
## Development Workflow
649651

@@ -690,9 +692,12 @@ The standard execution order for Process-PSModule workflows MUST be:
690692

691693
**Workflow Types**:
692694

693-
- **Production Workflow** (`.github/workflows/workflow.yml`) - Main workflow for consuming repositories
694-
- **CI Validation Workflow** (`.github/workflows/ci.yml`) - Integration tests for framework development
695-
- Consuming repositories use production workflow for releases, CI workflow for nightly validation
695+
- **Unified Production Workflow** (`.github/workflows/workflow.yml`) - Single workflow handling both CI and CD for consuming repositories
696+
- Intelligently executes appropriate jobs based on PR state (open/merged/abandoned)
697+
- Eliminates need for separate CI and release workflows
698+
- Uses conditional execution to optimize for different scenarios
699+
- **CI Validation Workflows** (`.github/workflows/Workflow-Test-*.yml`) - Integration tests for framework development
700+
- Consuming repositories use the unified production workflow for all scenarios
696701

697702
### Configuration
698703

@@ -745,4 +750,4 @@ For agent-specific runtime development guidance **when developing the framework*
745750

746751
**For Consuming Repositories**: Follow the Required Module Structure and Workflow Integration Requirements documented in the Product Overview section. Start with [Template-PSModule](https://github.com/PSModule/Template-PSModule).
747752

748-
**Version**: 1.6.0 | **Ratified**: TODO(RATIFICATION_DATE) | **Last Amended**: 2025-10-01
753+
**Version**: 1.6.1 | **Ratified**: TODO(RATIFICATION_DATE) | **Last Amended**: 2025-10-03

0 commit comments

Comments
 (0)