SMP window fills and centres instead of top-aligning; require opencode.md sync alongside README
This commit is contained in:
parent
d540a6a873
commit
10135b3d36
3 changed files with 28 additions and 17 deletions
39
opencode.md
39
opencode.md
|
|
@ -5,22 +5,29 @@ a minute. Read this first, then skim the files it points at.
|
|||
|
||||
---
|
||||
|
||||
## Keep README.md in sync — do this on EVERY prompt
|
||||
## Keep README.md AND opencode.md in sync — do this on EVERY prompt
|
||||
|
||||
**Before you finish any task, update `README.md` so it still matches the code.**
|
||||
This is a standing requirement, not a one-off. The README is meant to describe the
|
||||
project as it is right now, so treat it as part of "done":
|
||||
**Before you finish any task, update the docs so they still match the code.**
|
||||
This is a standing requirement, not a one-off, so treat it as part of "done":
|
||||
|
||||
- If a change adds/removes/renames a feature, script, route, app, theme, file or
|
||||
dependency, reflect it in `README.md` (Features, Tech Stack, API Routes, Project
|
||||
Structure, Scripts, running/deploying sections — whichever apply).
|
||||
- Re-read `README.md` and the files you touched; fix anything the change made stale.
|
||||
- Keep the author's voice and existing emoji-section formatting; don't rewrite the
|
||||
whole thing when a small edit will do.
|
||||
- If a task genuinely changes nothing user- or contributor-visible, it's fine to
|
||||
leave the README untouched — use judgement, don't churn it for nothing.
|
||||
**`README.md`** is the user/contributor-facing doc. If a change adds/removes/renames
|
||||
a feature, script, route, app, theme, file or dependency, reflect it in `README.md`
|
||||
(Features, Tech Stack, API Routes, Project Structure, Scripts, running/deploying
|
||||
sections — whichever apply).
|
||||
|
||||
When in doubt, prefer updating it. A stale README is treated as a bug.
|
||||
**`opencode.md`** (this file) is the cold-boot doc for the next session. Update it in
|
||||
the same task whenever a change touches anything it describes — architecture, the key
|
||||
files and their invariants, conventions/gotchas, history, or testing notes. A stale
|
||||
`opencode.md` is worse than none: it actively misleads the next session.
|
||||
|
||||
For both docs:
|
||||
- Re-read the doc and the files you touched; fix anything the change made stale.
|
||||
- Keep the author's voice and existing formatting; don't rewrite the whole thing when
|
||||
a small edit will do.
|
||||
- If a task genuinely changes nothing that either doc describes, it's fine to leave
|
||||
that doc untouched — use judgement, don't churn it for nothing.
|
||||
|
||||
When in doubt, prefer updating. A stale README **or** opencode.md is treated as a bug.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -244,9 +251,9 @@ list reordering, not free placement. Don't confuse the two.
|
|||
|
||||
## After finishing — push to git
|
||||
|
||||
First make sure `README.md` is up to date (see "Keep README.md in sync" at the
|
||||
top), then run **only** these three commands (no extra flags, no rebasing, no
|
||||
force-push):
|
||||
First make sure `README.md` **and** `opencode.md` are up to date (see "Keep
|
||||
README.md AND opencode.md in sync" at the top), then run **only** these three
|
||||
commands (no extra flags, no rebasing, no force-push):
|
||||
|
||||
```bash
|
||||
git add .
|
||||
|
|
|
|||
|
|
@ -752,7 +752,7 @@ export const SMP_APP: AppDef = {
|
|||
icon: "🎮",
|
||||
color: "#c0392b",
|
||||
width: 560,
|
||||
height: 430,
|
||||
height: 400,
|
||||
content: <SmpApp />,
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -625,7 +625,11 @@ a.win-icon {
|
|||
.smp {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
justify-content: center;
|
||||
gap: 14px;
|
||||
/* Fill the window body so the menu centres instead of leaving a gap under it;
|
||||
a short window scrolls via .win-body's overflow. */
|
||||
min-height: 100%;
|
||||
font-family: "Monocraft", "JetBrains Mono", monospace;
|
||||
color: #e6e6e6;
|
||||
background-color: #313131;
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue