Design modular Slugkit package architecture

erik commented

2026-06-28 16:34:29 -05:00

Owner

Copy link

Summary

Add docs/package-architecture.md with the proposed @evcraddock/slug-* package architecture.
Define package boundaries, dependency direction, incremental extraction phases, generated-site consumption model, versioning, publishing, and risks.
Add docs/npm-specs/ implementation specs for each package extraction unit, including template consumption and npm publish/deployment requirements.
Link the package architecture from the main architecture document.

Verification

./scripts/pre-pr.sh
Forgejo CI build-lint-test passed for commit a368519.

Task: #task-ca166842

## Summary - Add `docs/package-architecture.md` with the proposed `@evcraddock/slug-*` package architecture. - Define package boundaries, dependency direction, incremental extraction phases, generated-site consumption model, versioning, publishing, and risks. - Add `docs/npm-specs/` implementation specs for each package extraction unit, including template consumption and npm publish/deployment requirements. - Link the package architecture from the main architecture document. ## Verification - `./scripts/pre-pr.sh` - Forgejo CI `build-lint-test` passed for commit `a368519`. Task: #task-ca166842

erik added 1 commit

2026-06-28 16:34:30 -05:00

docs: design Slugkit package architecture

All checks were successful

CI / build-lint-test (pull_request) Successful in 48s

Details

5d03860ec9

Task: #task-ca166842

erik commented

2026-06-28 16:36:36 -05:00

Author

Owner

Copy link

Review summary

Approved. The PR adds the requested package architecture design and links it from the main architecture document.

Acceptance criteria

Documented architecture/design proposal exists in the repository: docs/package-architecture.md.
Proposal uses the @evcraddock/slug-* package naming strategy.
Proposal includes dependency direction and package dependency graph.
Proposal defines an incremental one-package-at-a-time implementation plan.
Proposal describes generated-site package consumption, ownership, customization, and escape hatches.
Proposal identifies follow-up implementation tasks/phases.

Blocking issues

None.

Warnings

None.

Verdict

Approved.

## Review summary Approved. The PR adds the requested package architecture design and links it from the main architecture document. ## Acceptance criteria - [x] Documented architecture/design proposal exists in the repository: `docs/package-architecture.md`. - [x] Proposal uses the `@evcraddock/slug-*` package naming strategy. - [x] Proposal includes dependency direction and package dependency graph. - [x] Proposal defines an incremental one-package-at-a-time implementation plan. - [x] Proposal describes generated-site package consumption, ownership, customization, and escape hatches. - [x] Proposal identifies follow-up implementation tasks/phases. ## Blocking issues None. ## Warnings None. ## Verdict Approved.

erik referenced this pull request

2026-06-28 16:39:07 -05:00

Design modular Slugkit package architecture #228

erik force-pushed feat/task-ca166842-package-architecture from 5d03860ec9

All checks were successful

CI / build-lint-test (pull_request) Successful in 48s

Details

to a3685196b7

All checks were successful

CI / build-lint-test (pull_request) Successful in 49s

Details

2026-06-28 22:25:23 -05:00

Compare

erik commented

2026-06-28 22:27:15 -05:00

Author

Owner

Copy link

Review summary

Approved after the npm-specs expansion. The PR now includes the package architecture plus implementation-unit specs that require template-site consumption and npm publish/deployment outcomes for each package.

Acceptance criteria

Documented architecture/design proposal exists in the repository: docs/package-architecture.md.
Proposal uses the @evcraddock/slug-* package naming strategy.
Proposal includes dependency direction and package dependency graph.
Proposal defines an incremental one-package-at-a-time implementation plan.
Proposal describes generated-site package consumption, ownership, customization, and escape hatches.
Proposal identifies follow-up implementation tasks/phases through docs/npm-specs/.

Additional review notes

docs/npm-specs/ breaks the architecture into concrete implementation specs.
Each package spec includes template-site integration requirements.
Each package spec includes release/deployment requirements for npm publication and post-publish verification.

Blocking issues

None.

Warnings

None.

Verdict

Approved.

## Review summary Approved after the npm-specs expansion. The PR now includes the package architecture plus implementation-unit specs that require template-site consumption and npm publish/deployment outcomes for each package. ## Acceptance criteria - [x] Documented architecture/design proposal exists in the repository: `docs/package-architecture.md`. - [x] Proposal uses the `@evcraddock/slug-*` package naming strategy. - [x] Proposal includes dependency direction and package dependency graph. - [x] Proposal defines an incremental one-package-at-a-time implementation plan. - [x] Proposal describes generated-site package consumption, ownership, customization, and escape hatches. - [x] Proposal identifies follow-up implementation tasks/phases through `docs/npm-specs/`. ## Additional review notes - `docs/npm-specs/` breaks the architecture into concrete implementation specs. - Each package spec includes template-site integration requirements. - Each package spec includes release/deployment requirements for npm publication and post-publish verification. ## Blocking issues None. ## Warnings None. ## Verdict Approved.

erik referenced this pull request

2026-06-28 22:27:30 -05:00

Design modular Slugkit package architecture #228

erik merged commit bfa747e545 into main

2026-06-28 22:30:44 -05:00

erik deleted branch feat/task-ca166842-package-architecture

2026-06-28 22:30:44 -05:00

erik referenced this pull request from a commit

2026-06-28 22:30:44 -05:00

Merge pull request 'Design modular Slugkit package architecture' (#229) from feat/task-ca166842-package-architecture into main

erik referenced this pull request

2026-06-28 22:33:12 -05:00