Skip to content

docs: add supply chain rules and Windows development guide#1837

Merged
OneStepAt4time merged 1 commit intodevelopfrom
docs/supply-chain-rules
Apr 15, 2026
Merged

docs: add supply chain rules and Windows development guide#1837
OneStepAt4time merged 1 commit intodevelopfrom
docs/supply-chain-rules

Conversation

@OneStepAt4time
Copy link
Copy Markdown
Owner

Summary

Two documentation updates per Athena's assignment (P2, milestone #14):

1. CONTRIBUTING.md β€” Development Supply Chain Rules (NEW section)

Added "Development Supply Chain Rules" section covering:

  • Chain of Custody β€” issue β†’ PRD β†’ worktree β†’ PR β†’ review β†’ merge
  • Absolute Rules β€” never force push, always before starting, zero coverage bypasses, needs label
  • PR Size β€” target <500 lines
  • Dogfooding β€” use Aegis for Aegis development, escalate if unavailable
  • Windows Development β€” reference to Windows Setup guide

2. docs/windows-development.md β€” Windows Development Guide (NEW file)

Comprehensive Windows development guide covering:

  • Content-Length CRLF mismatch issue (with reference to POST /v1/sessions/:id/send fails with Content-Length mismatch on WindowsΒ #1766)
  • Line ending conversion differences (CRLF vs LF)
  • psmux vs tmux comparison table
  • Windows development setup (nvm-windows, Git config, line endings)
  • Running tests on Windows
  • Common Windows issues (socket paths, PowerShell path expansion, Git line endings)
  • CI on Windows considerations
  • Reporting Windows bugs template

Changes

  • : +165 lines (supply chain section + Windows development reference)
  • : +135 lines (new file)

Note

The Content-Length CRLF section will be updated after #1766 merges to reference the actual fix implementation.

Closes Athena assignment (P2, milestone #14)

Aegis version: 0.5.3-alpha
Milestone: Documentation
Assignee: Scribe

Copy link
Copy Markdown
Contributor

@aegis-gh-agent aegis-gh-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

βœ… Approved β€” supply chain rules in CONTRIBUTING.md + Windows development guide.

@OneStepAt4time OneStepAt4time merged commit 4d3d02f into develop Apr 15, 2026
9 of 11 checks passed
@OneStepAt4time OneStepAt4time deleted the docs/supply-chain-rules branch April 15, 2026 07:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant