@jskit-ai/agent-docs 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/DISTR_AGENT.md +11 -1
  2. package/guide/agent/app-extras/assistant.md +1 -1
  3. package/guide/agent/app-extras/realtime.md +1 -1
  4. package/guide/agent/app-setup/a-more-interesting-shell.md +1 -1
  5. package/guide/agent/app-setup/authentication.md +9 -1
  6. package/guide/agent/app-setup/console.md +1 -1
  7. package/guide/agent/app-setup/database-layer.md +1 -1
  8. package/guide/agent/app-setup/initial-scaffolding.md +1 -1
  9. package/guide/agent/app-setup/multi-homing.md +3 -1
  10. package/guide/agent/app-setup/users.md +1 -1
  11. package/guide/agent/app-setup/working-with-the-jskit-cli.md +1 -1
  12. package/guide/agent/generators/advanced-cruds.md +163 -1
  13. package/guide/agent/generators/crud-generators.md +30 -1
  14. package/guide/agent/generators/intro.md +1 -1
  15. package/guide/agent/generators/ui-generators.md +1 -1
  16. package/guide/agent/index.md +1 -1
  17. package/package.json +1 -1
  18. package/reference/autogen/packages/agent-docs.md +18 -0
  19. package/skills/jskit-review/SKILL.md +12 -2
  20. package/templates/APP_BLUEPRINT.md +9 -0
  21. package/templates/WORKBOARD.md +3 -3
  22. package/templates/app/AGENTS.md +15 -3
  23. package/workflow/bootstrap.md +17 -2
  24. package/workflow/feature-delivery.md +19 -3
  25. package/workflow/review.md +9 -3
  26. package/workflow/scoping.md +10 -1
  27. package/workflow/workboard.md +1 -1
  28. package/guide/human/app-extras/assistant.md +0 -693
  29. package/guide/human/app-extras/realtime.md +0 -268
  30. package/guide/human/app-setup/a-more-interesting-shell.md +0 -732
  31. package/guide/human/app-setup/authentication.md +0 -961
  32. package/guide/human/app-setup/console.md +0 -350
  33. package/guide/human/app-setup/database-layer.md +0 -820
  34. package/guide/human/app-setup/initial-scaffolding.md +0 -753
  35. package/guide/human/app-setup/multi-homing.md +0 -793
  36. package/guide/human/app-setup/users.md +0 -402
  37. package/guide/human/app-setup/working-with-the-jskit-cli.md +0 -1047
  38. package/guide/human/generators/advanced-cruds.md +0 -921
  39. package/guide/human/generators/crud-generators.md +0 -554
  40. package/guide/human/generators/intro.md +0 -107
  41. package/guide/human/generators/ui-generators.md +0 -663
  42. package/guide/human/index.md +0 -37
package/workflow/scoping.md CHANGED
@@ -22,17 +22,26 @@ The blueprint must capture at least:
22
22
  - package install plan
23
23
  - generator plan
24
24
  - custom-code areas
25
+ - baseline package-owned workflows and any intended overrides
25
26
  - delivery plan broken into chunks
27
+ - CRUD-specific operation and screen decisions where relevant
26
28
 
27
29
  Scoping rules:
28
30
 
29
- - Use `guide/agent/index.md` for fast navigation and `guide/human/index.md` for exact details.
31
+ - Use `guide/agent/index.md` for fast navigation and `site/guide/index.md` for exact details.
30
32
  - Inspect packages and generators before choosing them.
31
33
  - Decide ownership early; do not treat it as a UI-only detail.
32
34
  - If Stage 1 platform choices are still provisional, finish them before installing tenancy-sensitive runtime packages.
35
+ - Record which selected JSKIT package-owned workflows are accepted as baseline and which, if any, need custom behavior.
36
+ - Do not ask the developer to redesign package-owned baseline workflows from scratch. Ask only whether the default behavior is accepted or whether the app needs overrides, restrictions, or extensions.
33
37
  - Create or refresh `.jskit/WORKBOARD.md` for substantial or multi-chunk work so the request has an explicit execution tracker.
34
38
  - Break delivery into chunks that can be independently reviewed and tested.
35
39
  - One CRUD is usually one chunk. Platform setup, shell work, and cross-cutting integrations may also be separate chunks.
40
+ - For each CRUD chunk, decide these before implementation:
41
+ - which operations exist: `list`, `view`, `new`, `edit`, `delete`, or a narrower set
42
+ - which fields appear in the list view if a list exists
43
+ - the intended structure and visual hierarchy of the view form
44
+ - the intended structure and visual hierarchy of the edit/new form
36
45
  - If the package/runtime choice is unclear, stop and resolve it before writing implementation code.
37
46
 
38
47
  No feature implementation should start until the blueprint covers database, screens, functional boundaries, and chunk plan well enough that the implementation path is obvious.
package/workflow/workboard.md CHANGED
@@ -17,7 +17,7 @@ Purpose:
17
17
 
18
18
  - track the current request
19
19
  - record the current stage and current chunk
20
- - track chunk status across implementation, deslop, JSKIT review, and verification
20
+ - track chunk status across implementation, deslop, JSKIT review, UI review, and verification
21
21
  - record blockers, open questions, and remaining gaps
22
22
 
23
23
  Workboard rules: