prizmkit 1.0.99 → 1.0.100
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.
package/bundled/VERSION.json
CHANGED
|
@@ -43,10 +43,10 @@ BROWNFIELD WORKFLOW (existing project):
|
|
|
43
43
|
**Step 1: Project Scanning**
|
|
44
44
|
1. Detect tech stack from build files (`package.json`, `requirements.txt`, `go.mod`, `pom.xml`, `Cargo.toml`, etc.)
|
|
45
45
|
2. Map directory structure using a TWO-TIER model — flat structures lose the nesting relationships that AI needs to navigate the codebase:
|
|
46
|
-
- TOP-LEVEL modules: directories directly under project root that contain source files or sub-directories with source files (e.g. `
|
|
47
|
-
- SUB-MODULES: directories INSIDE a top-level module (e.g. `
|
|
46
|
+
- TOP-LEVEL modules: directories directly under project root that contain source files or sub-directories with source files (e.g. `src/`, `internal/`, `lib/`)
|
|
47
|
+
- SUB-MODULES: directories INSIDE a top-level module (e.g. `src/routes/`, `src/models/`)
|
|
48
48
|
- A sub-module maps to `.prizm-docs/<M>/<S>.prizm`, never to `.prizm-docs/<S>.prizm` — flattening would create ambiguous paths when two modules have identically-named sub-modules
|
|
49
|
-
- Exclude: `.git/`, `node_modules/`, `vendor/`, `build/`, `dist/`, `__pycache__/`, `.claude/`, `.codebuddy/`, `.prizmkit/`, `.prizm-docs/`
|
|
49
|
+
- Exclude: `.git/`, `node_modules/`, `vendor/`, `build/`, `dist/`, `__pycache__/`, `target/`, `bin/`, `.claude/`, `.codebuddy/`, `.prizmkit/`, `.prizm-docs/`, `dev-pipeline/`
|
|
50
50
|
3. Identify entry points by language convention
|
|
51
51
|
4. Catalog dependencies (external packages)
|
|
52
52
|
5. Count source files per directory
|
|
@@ -48,7 +48,7 @@ STEPS:
|
|
|
48
48
|
- TOP-LEVEL modules: directories directly under project root (or under src/ for src-based layouts) that contain 3+ source files OR contain sub-directories with 3+ source files. These go into MODULE_INDEX.
|
|
49
49
|
- SUB-MODULES: directories INSIDE a top-level module that contain 3+ source files. Listed in the parent L1 doc's SUBDIRS section only.
|
|
50
50
|
- HIERARCHY RULE: directory X inside top-level module M maps to .prizm-docs/<M>/<X>.prizm, never to .prizm-docs/<X>.prizm.
|
|
51
|
-
- Exclude
|
|
51
|
+
- Exclude .git/, node_modules/, vendor/, build/, dist/, __pycache__/, target/, bin/, .claude/, .codebuddy/, .prizmkit/, .prizm-docs/, dev-pipeline/. If top-level module count > 30, ask user for include/exclude patterns.
|
|
52
52
|
3. Create .prizm-docs/ directory structure mirroring the source tree exactly. For each top-level module M that has sub-modules, create the subdirectory .prizm-docs/<M>/.
|
|
53
53
|
4. Generate root.prizm (L0) with PROJECT, LANG, FRAMEWORK, BUILD, TEST, ENTRY, MODULE_INDEX listing only top-level modules with arrow pointers to .prizm-docs/<M>.prizm (sub-modules stay out of MODULE_INDEX to keep L0 compact and within the 4KB limit), RULES extracted from CODEBUDDY.md/CLAUDE.md/README/linter configs, and PATTERNS. Set PRIZM_VERSION: 2, UPDATED: today's date. Max 4KB.
|
|
54
54
|
5. Generate L1 .prizm files for ALL modules (top-level and sub-modules), each at its correct mirrored path:
|
|
@@ -479,19 +479,19 @@ STEPS:
|
|
|
479
479
|
a. IDENTIFY TOP-LEVEL modules: directories directly under project root (or directly under src/ for src-based layouts) that either:
|
|
480
480
|
- Contain 3+ source files of the primary language, OR
|
|
481
481
|
- Contain sub-directories that each have 3+ source files
|
|
482
|
-
RESULT: top_modules = [
|
|
482
|
+
RESULT: top_modules = [src, internal, app, lib, ...]
|
|
483
483
|
|
|
484
484
|
b. IDENTIFY SUB-MODULES: for each top-level module M, find directories INSIDE M that contain 3+ source files
|
|
485
485
|
RESULT: sub_modules[M] = [scripts, lib, templates, ...] (relative names, not full paths)
|
|
486
486
|
|
|
487
487
|
c. HIERARCHY RULE: if directory X lives inside top-level module M, X is a sub-module of M — NOT a separate top-level module.
|
|
488
|
-
WRONG:
|
|
489
|
-
CORRECT:
|
|
488
|
+
WRONG: src/routes/ treated as top-level module -> .prizm-docs/routes.prizm
|
|
489
|
+
CORRECT: src/routes/ is a sub-module of src -> .prizm-docs/src/routes.prizm
|
|
490
490
|
|
|
491
491
|
d. MODULE_INDEX in root.prizm lists ONLY top-level modules from step 2a.
|
|
492
492
|
Sub-modules appear in their parent's L1 doc SUBDIRS section, not in MODULE_INDEX.
|
|
493
493
|
|
|
494
|
-
- EXCLUDE:
|
|
494
|
+
- EXCLUDE: .git/, node_modules/, vendor/, build/, dist/, __pycache__/, target/, bin/, .claude/, .codebuddy/, .prizmkit/, .prizm-docs/, dev-pipeline/
|
|
495
495
|
IF top-level module count > 30: ASK user for include/exclude patterns
|
|
496
496
|
|
|
497
497
|
3. CREATE_DIRECTORY_STRUCTURE:
|
|
@@ -499,10 +499,10 @@ STEPS:
|
|
|
499
499
|
For each top-level module M that has sub-modules: create .prizm-docs/<M>/ directory
|
|
500
500
|
RULE: .prizm-docs/ directory tree must mirror the source directory tree exactly
|
|
501
501
|
EXAMPLE:
|
|
502
|
-
source:
|
|
503
|
-
source:
|
|
504
|
-
source:
|
|
505
|
-
NEVER create .prizm-docs/
|
|
502
|
+
source: src/routes/ -> prizm: .prizm-docs/src/routes.prizm
|
|
503
|
+
source: src/models/ -> prizm: .prizm-docs/src/models.prizm
|
|
504
|
+
source: src/ -> prizm: .prizm-docs/src.prizm
|
|
505
|
+
NEVER create .prizm-docs/routes.prizm for a directory that lives at src/routes/
|
|
506
506
|
|
|
507
507
|
4. GENERATE_ROOT (L0):
|
|
508
508
|
Fill: PROJECT, LANG, FRAMEWORK, BUILD, TEST, ENTRY from step 1
|