|
| 1 | +# Website Agent Instructions |
| 2 | + |
| 3 | +## Dependency Policy |
| 4 | + |
| 5 | +The `website/` directory is the nowake.ai site repository. |
| 6 | + |
| 7 | +This site currently has no legacy compatibility burden. |
| 8 | + |
| 9 | +When adding or upgrading tools, frameworks, libraries, runtimes, or build dependencies, prefer the latest stable version by default. |
| 10 | + |
| 11 | +Do not pin to older major versions for compatibility unless there is a clear, documented reason, such as: |
| 12 | + |
| 13 | +- the latest stable version is incompatible with the target runtime or hosting platform; |
| 14 | +- the latest stable version has a known blocking bug or security issue; |
| 15 | +- a project-specific integration explicitly requires an older version. |
| 16 | + |
| 17 | +If an older dependency version is chosen, document the reason near the dependency change or in the relevant project notes. |
| 18 | + |
| 19 | +## Project Page Content Rules |
| 20 | + |
| 21 | +When creating or revising a project page, follow `PROJECT_PAGE_STANDARD.md`. Project pages must share nowake.ai visual language, but each project needs a page structure tailored to its own product shape; do not reuse one fixed page template across projects. |
| 22 | + |
| 23 | +For every project page, do both jobs well: |
| 24 | + |
| 25 | +- Explain the project principle clearly enough that a new visitor can understand how it works. |
| 26 | +- Put the core product selling points near the top, in concise and concrete language. |
| 27 | + |
| 28 | +Do not let architecture explanation bury the value proposition. Project pages should make the main benefit obvious before deeper implementation details. |
| 29 | + |
| 30 | +Current emphasis: |
| 31 | + |
| 32 | +- `kube-insight`: treat it as a foundational AIOps infrastructure component with large future surface area. Its page can use more eye-catching, forceful copy, but the claims must stay grounded in concrete retained-evidence workflows, performance proof, and current shipped capabilities. Highlight that it is agent-friendly, supports multiple operating/storage modes, and can be dramatically faster than broad live `kubectl` investigation workflows because it queries retained, pre-extracted evidence. |
| 33 | +- `svc-lb-mux`: treat it as a narrow, original, operations-first tool for teams that need to expose many TCP/UDP services through provider L4 load balancers while caring about cost, quota, IP, forwarding rule, or port pressure. Its copy should be plain and specific: make the use case, user, product advantage, provider limits, and migration path obvious before controller internals. |
0 commit comments