feat: add target repo examples and file layout guidance

This commit is contained in:
2026-04-29 21:55:22 +08:00
parent c507e52dc1
commit 5c80bc12fd
17 changed files with 253 additions and 3 deletions

View File

@@ -0,0 +1,13 @@
# Harness Health
- project map clarity: partial
- validation commands: strong
- fast feedback: partial
- task templates: partial
- guardrails: strong
- doc-code alignment: partial
## Top priorities
1. Document workspace crate roles more clearly
2. Call out feature-flag-specific validation paths
3. Keep examples aligned with actual crate boundaries

View File

@@ -0,0 +1,10 @@
# Project Map
## Main structure
- root crate or workspace declared in `Cargo.toml`
- `src/main.rs` or `src/lib.rs` as primary entrypoints
- `crates/` for workspace members where applicable
## Notes
- Distinguish unit tests from integration tests
- Check whether feature flags alter build or test behavior

View File

@@ -0,0 +1,6 @@
# Risk Guardrails
- Do not casually modify `Cargo.lock`
- Be careful with feature flags and workspace-wide effects
- Avoid broad lifetime or trait refactors for narrow tasks
- Treat unsafe code paths as high scrutiny areas

View File

@@ -0,0 +1,14 @@
# Task Templates
## Bugfix
1. Read the affected module and relevant tests
2. Confirm whether the crate is part of a workspace
3. Implement the narrowest safe fix
4. Run targeted checks first, then broader cargo validation
5. Report any feature-flag or cross-crate risks
## Feature
1. Preserve existing public interfaces unless instructed otherwise
2. Keep new dependencies to a minimum
3. Add tests for normal and edge cases
4. Run fmt, clippy, and tests before reporting completion