From 6a172364748eb7e13495646dc4a29e56f77bfe28 Mon Sep 17 00:00:00 2001
From: 0x1d <admin@dcentral.systems>
Date: Tue, 4 Nov 2025 22:02:50 +0100
Subject: [PATCH] docs: add implementation plan, ADRs, and task tracking system

- Add comprehensive 8-phase implementation plan (docs/plan.md)
- Add 28 Architecture Decision Records (docs/adr/) covering all phases
- Add task tracking system with 283+ task files (docs/stories/)
- Add task generator script for automated task file creation
- Add reference playbooks and requirements documentation

This commit establishes the complete planning foundation for the Go
Platform implementation, documenting all architectural decisions and
providing detailed task breakdown for Phases 0-8.
---
 .cursor/rules/golang.md                       |   95 ++
 docs/adr/0001-go-module-path.md               |   37 +
 docs/adr/0002-go-version.md                   |   39 +
 .../0003-dependency-injection-framework.md    |   49 +
 docs/adr/0004-configuration-management.md     |   50 +
 docs/adr/0005-logging-framework.md            |   50 +
 docs/adr/0006-http-framework.md               |   50 +
 docs/adr/0007-project-directory-structure.md  |   82 +
 docs/adr/0008-error-handling-strategy.md      |   57 +
 docs/adr/0009-context-key-types.md            |   56 +
 docs/adr/0010-ci-cd-platform.md               |   50 +
 docs/adr/0011-code-generation-tools.md        |   53 +
 docs/adr/0012-logger-interface-design.md      |   62 +
 docs/adr/0013-database-orm.md                 |   54 +
 docs/adr/0014-health-check-implementation.md  |   52 +
 docs/adr/0015-error-bus-implementation.md     |   55 +
 docs/adr/0016-opentelemetry-observability.md  |   56 +
 docs/adr/0017-jwt-token-strategy.md           |   55 +
 docs/adr/0018-password-hashing.md             |   53 +
 docs/adr/0019-permission-dsl-format.md        |   57 +
 docs/adr/0020-audit-logging-storage.md        |   63 +
 docs/adr/0021-module-loading-strategy.md      |   54 +
 docs/adr/0022-cache-implementation.md         |   56 +
 docs/adr/0023-event-bus-implementation.md     |   59 +
 docs/adr/0024-job-scheduler.md                |   56 +
 docs/adr/0025-multitenancy-model.md           |   49 +
 docs/adr/0026-error-reporting-service.md      |   54 +
 docs/adr/0027-rate-limiting-strategy.md       |   54 +
 docs/adr/0028-testing-strategy.md             |   67 +
 docs/adr/README.md                            |   86 +
 docs/plan.md                                  | 1485 +++++++++++++++++
 docs/playbook.md                              |  620 +++++++
 docs/requirements.md                          |  319 ++++
 docs/stories/COMPLETE_TASK_LIST.md            |   62 +
 docs/stories/README.md                        |   63 +
 docs/stories/TASK_TEMPLATE.md                 |   54 +
 docs/stories/generate_tasks.py                |  219 +++
 ...go-module-go-mod-init-githubcomyourorgp.md |   47 +
 .../phase0/0.1.1-initialize-go-module.md      |   47 +
 .../0.1.2-create-directory-structure.md       |   77 +
 .../0.1.3-add-gitignore-for-go-projects.md    |   56 +
 docs/stories/phase0/0.1.3-add-gitignore.md    |   56 +
 .../phase0/0.1.4-create-initial-readme.md     |   63 +
 ...-initial-readmemd-with-project-overview.md |   63 +
 .../0.2.1-install-config-dependencies.md      |   47 +
 ...hubcomspf13viper-and-githubcomspf13cobr.md |   47 +
 .../phase0/0.2.2-create-config-interface.md   |   59 +
 ....2.2-create-pkgconfigconfiggo-interface.md |   59 +
 .../phase0/0.2.3-implement-config-loader.md   |   60 +
 ...ment-internalconfigconfiggo-using-viper.md |   60 +
 ...-configdefaultyaml-with-basic-structure.md |   67 +
 .../0.2.4-create-configuration-files.md       |   67 +
 ...lconfigloadergo-with-loadconfig-functio.md |   40 +
 .../phase0/0.3.1-install-gouberorgzap.md      |   33 +
 .../0.3.1-install-logging-dependencies.md     |   33 +
 ....3.2-create-pkgloggerloggergo-interface.md |   52 +
 ....3-implement-internalloggerzap_loggergo.md |   40 +
 ...est-id-middleware-helper-gin-middleware.md |   40 +
 .../0.4.1-create-githubworkflowsciyml.md      |   40 +
 ...0.4.2-add-makefile-with-common-commands.md |   40 +
 .../phase0/0.5.1-install-gouberorgfx.md       |   40 +
 .../0.5.2-create-internaldicontainergo.md     |   40 +
 ...0.5.3-create-cmdplatformmaingo-skeleton.md |   40 +
 docs/stories/phase0/README.md                 |   47 +
 .../1.1.1-extend-internaldicontainergo.md     |   40 +
 .../1.1.2-create-internaldiprovidersgo.md     |   40 +
 .../1.1.3-add-internaldicore_modulego.md      |   40 +
 .../phase1/1.2.1-install-entgoioentcmdent.md  |   40 +
 .../phase1/1.2.2-initialize-ent-schema.md     |   46 +
 ...fine-core-entities-in-internalentschema.md |   40 +
 ...nerate-ent-code-go-generate-internalent.md |   40 +
 ....5-create-internalinfradatabaseclientgo.md |   40 +
 ...dd-database-config-to-configdefaultyaml.md |   40 +
 ...hubcomprometheusclient_golangprometheus.md |   40 +
 ...hubcomheptiolabshealthcheck-optional-or.md |   40 +
 ....3.3-create-pkghealthhealthgo-interface.md |   48 +
 ....3.4-implement-internalhealthregistrygo.md |   40 +
 .../1.3.5-create-internalmetricsmetricsgo.md  |   40 +
 ...-add-metrics-endpoint-prometheus-format.md |   40 +
 ...-register-endpoints-in-main-http-router.md |   40 +
 ...-create-pkgerrorbuserrorbusgo-interface.md |   48 +
 ...implement-internalerrorbuschannel_busgo.md |   40 +
 ...ecovery-middleware-that-publishes-to-er.md |   40 +
 ....4.4-register-error-bus-in-di-container.md |   40 +
 .../1.5.1-install-githubcomgin-gonicgin.md    |   40 +
 .../1.5.2-create-internalserverservergo.md    |   40 +
 ....5.3-wire-http-server-into-fx-lifecycle.md |   40 +
 ...e-cmdplatformmaingo-to-use-fx-lifecycle.md |   40 +
 .../1.6.1-install-opentelemetry-packages.md   |   40 +
 ....2-create-internalobservabilitytracergo.md |   40 +
 ...6.3-add-http-instrumentation-middleware.md |   40 +
 ...d-trace-context-propagation-to-requests.md |   40 +
 .../2.1.1-install-githubcomgolang-jwtjwtv5.md |   40 +
 .../2.1.2-create-pkgauthauthgo-interfaces.md  |   56 +
 .../2.1.3-implement-internalauthjwt_authgo.md |   40 +
 .../2.1.4-create-internalauthmiddlewarego.md  |   40 +
 ...-add-login-endpoint-post-apiv1authlogin.md |   40 +
 ...-refresh-endpoint-post-apiv1authrefresh.md |   40 +
 ...create-pkgidentityidentitygo-interfaces.md |   59 +
 ...t-internalidentityuser_repogo-using-ent.md |   40 +
 ...mplement-internalidentityuser_servicego.md |   40 +
 docs/stories/phase2/2.2.4-add-endpoints.md    |   40 +
 .../phase2/2.3.1-create-pkgpermpermgo.md      |   59 +
 ....3.2-create-pkgpermresolvergo-interface.md |   49 +
 ...lement-internalpermin_memory_resolvergo.md |   40 +
 .../2.3.4-create-pkgauthauthzgo-interface.md  |   48 +
 ...implement-internalauthrbac_authorizergo.md |   40 +
 .../2.3.6-create-authorization-middleware.md  |   40 +
 ....4.1-create-internalidentityrole_repogo.md |   40 +
 docs/stories/phase2/2.4.2-add-endpoints.md    |   40 +
 .../2.5.1-create-pkgauditauditgo-interface.md |   55 +
 ....2-implement-internalauditent_auditorgo.md |   40 +
 .../phase2/2.5.3-add-audit-middleware.md      |   40 +
 .../2.5.4-integrate-with-auth-endpoints.md    |   40 +
 .../phase2/2.6.1-create-internalseedseedgo.md |   40 +
 .../phase3/3.1.1-create-pkgmodulemodulego.md  |   52 +
 .../3.1.2-create-pkgmodulemanifestgo.md       |   52 +
 ...uleyaml-schema-used-for-code-generation.md |   40 +
 ...3.2.1-create-internalregistryregistrygo.md |   40 +
 .../3.2.2-add-registration-validation.md      |   40 +
 ....1-create-scriptsgenerate-permissionsgo.md |   40 +
 ...d-gogenerate-directive-to-pkgpermpermgo.md |   40 +
 ...ate-makefile-with-make-generate-command.md |   40 +
 ...4.1-create-internalpluginloaderloadergo.md |   40 +
 ...ent-internalpluginloaderstatic_loadergo.md |   40 +
 ...nternalpluginloaderplugin_loadergo-opti.md |   40 +
 ....5.1-create-internalmoduleinitializergo.md |   40 +
 docs/stories/phase3/3.5.2-run-migrations.md   |   40 +
 .../phase3/3.6.1-extend-pkgmodulemodulego.md  |   50 +
 .../3.6.2-integrate-with-fxlifecycle.md       |   40 +
 .../3.7.1-create-cmdplatformctlmaingo.md      |   40 +
 .../3.7.2-add-to-makefile-make-install-cli.md |   40 +
 .../4.1.1-create-modulesblog-directory.md     |   58 +
 docs/stories/phase4/4.1.2-initialize-gomod.md |   47 +
 .../4.2.1-create-modulesblogmoduleyaml.md     |   70 +
 ...-create-modulesbloginternaldomainpostgo.md |   53 +
 ...schema-modulesbloginternalentschemapost.md |   40 +
 ...4.3.3-generate-ent-code-for-blog-module.md |   40 +
 ...te-modulesbloginternaldomainpost_repogo.md |   52 +
 ...ement-using-ent-client-shared-from-core.md |   40 +
 ...odulesbloginternalservicepost_servicego.md |   40 +
 ...-create-modulesbloginternalapihandlergo.md |   40 +
 .../4.6.2-use-authorization-middleware.md     |   46 +
 ...4.6.3-register-handlers-in-modules-init.md |   40 +
 .../4.7.1-create-modulesblogpkgmodulego.md    |   70 +
 ...pdate-main-gomod-to-include-blog-module.md |   46 +
 ...import-blog-module-in-cmdplatformmaingo.md |   46 +
 ...run-permission-generation-make-generate.md |   40 +
 ...4-verify-blog-permissions-are-generated.md |   40 +
 ...gration-test-modulesbloginternalapihand.md |   40 +
 ...d-unit-tests-for-service-and-repository.md |   40 +
 .../5.1.1-install-githubcomredisgo-redisv9.md |   40 +
 ...2-create-pkginfracachecachego-interface.md |   50 +
 ...plement-internalinfracacheredis_cachego.md |   40 +
 ...4-add-redis-config-to-configdefaultyaml.md |   40 +
 .../phase5/5.1.5-register-in-di-container.md  |   40 +
 ...middleware-for-selected-routes-optional.md |   40 +
 ...-create-pkgeventbuseventbusgo-interface.md |   49 +
 ...plement-internalinfrabusinprocess_busgo.md |   40 +
 ...3-implement-internalinfrabuskafka_busgo.md |   40 +
 ...4-add-kafka-config-to-configdefaultyaml.md |   40 +
 ...s-in-di-container-switchable-via-config.md |   40 +
 docs/stories/phase5/5.2.6-add-core-events.md  |   40 +
 ...tall-githubcomawsaws-sdk-go-v2services3.md |   40 +
 ...3.2-create-pkginfrablobblobgo-interface.md |   51 +
 ...3-implement-internalinfrablobs3_storego.md |   40 +
 ....3.4-add-s3-config-to-configdefaultyaml.md |   40 +
 .../phase5/5.3.5-register-in-di-container.md  |   40 +
 ...e-upload-endpoint-post-apiv1filesupload.md |   40 +
 .../5.4.1-install-githubcomgo-mailmail.md     |   40 +
 ...pkgnotificationnotificationgo-interface.md |   49 +
 ...ement-internalinfraemailsmtp_notifiergo.md |   40 +
 ...4-add-email-config-to-configdefaultyaml.md |   40 +
 .../5.4.5-integrate-with-identity-service.md  |   40 +
 .../phase5/5.4.6-register-in-di-container.md  |   40 +
 ...hubcomrobfigcronv3-and-githubcomhibiken.md |   40 +
 ...reate-pkgschedulerschedulergo-interface.md |   49 +
 ...internalinfraschedulerasynq_schedulergo.md |   40 +
 ...te-internalinfraschedulerjob_registrygo.md |   40 +
 docs/stories/phase5/5.5.5-add-example-jobs.md |   40 +
 ...monitoring-endpoint-get-apiv1jobsstatus.md |   40 +
 ...create-pkginfrasecretsecretgo-interface.md |   48 +
 ...nternalinfrasecretvault_storego-hashico.md |   40 +
 ...nternalinfrasecretaws_secretsgo-aws-sec.md |   40 +
 .../5.6.4-integrate-with-config-loader.md     |   40 +
 ...ter-in-di-container-optional-via-config.md |   40 +
 ....7.1-create-pkgtenanttenantgo-interface.md |   48 +
 ....7.2-implement-internaltenantresolvergo.md |   40 +
 .../phase5/5.7.3-add-tenant-middleware.md     |   40 +
 ...date-ent-queries-to-filter-by-tenant_id.md |   40 +
 ...update-user-entity-to-include-tenant_id.md |   40 +
 .../6.1.1-complete-opentelemetry-setup.md     |   40 +
 .../phase6/6.1.2-create-custom-spans.md       |   40 +
 .../6.1.3-add-trace-context-propagation.md    |   40 +
 ...2.1-install-githubcomgetsentrysentry-go.md |   40 +
 .../phase6/6.2.2-integrate-with-error-bus.md  |   40 +
 .../phase6/6.2.3-add-sentry-middleware.md     |   40 +
 .../6.2.4-configure-sentry-dsn-via-config.md  |   40 +
 .../phase6/6.3.1-add-request-correlation.md   |   40 +
 .../phase6/6.3.2-add-structured-fields.md     |   40 +
 .../6.3.3-create-log-aggregation-config.md    |   40 +
 docs/stories/phase6/6.4.1-add-more-metrics.md |   40 +
 .../phase6/6.4.2-create-metric-labels.md      |   40 +
 .../6.5.1-create-opsgrafanadashboards.md      |   40 +
 ...ent-dashboard-setup-in-docsoperationsmd.md |   40 +
 .../6.6.1-install-githubcomululelimiterv3.md  |   40 +
 .../6.6.2-create-rate-limit-middleware.md     |   40 +
 .../phase6/6.6.3-add-rate-limit-config.md     |   49 +
 .../6.6.4-return-x-ratelimit--headers.md      |   40 +
 .../6.7.1-add-security-headers-middleware.md  |   40 +
 .../phase6/6.7.2-add-request-size-limits.md   |   40 +
 .../phase6/6.7.3-add-input-validation.md      |   40 +
 .../6.7.4-add-sql-injection-protection.md     |   40 +
 .../6.8.1-add-database-connection-pooling.md  |   40 +
 .../phase6/6.8.2-add-query-optimization.md    |   40 +
 .../phase6/6.8.3-add-response-compression.md  |   40 +
 .../phase6/6.8.4-add-caching-strategy.md      |   40 +
 ...hieve-80-code-coverage-for-core-modules.md |   40 +
 ...githubcomstretchrtestify-for-assertions.md |   40 +
 ...ithubcomgolangmock-or-mockery-for-mocks.md |   40 +
 docs/stories/phase7/7.1.4-add-test-helpers.md |   40 +
 ...ithubcomtestcontainerstestcontainers-go.md |   40 +
 .../7.2.2-create-integration-test-suite.md    |   40 +
 docs/stories/phase7/7.2.3-test-scenarios.md   |   40 +
 .../7.2.4-create-docker-composetestyml.md     |   40 +
 ...7.2.5-add-test-tags-gobuild-integration.md |   40 +
 ...ithubcompact-foundationpact-go-optional.md |   40 +
 .../phase7/7.3.2-create-api-contract-tests.md |   40 +
 .../phase7/7.3.3-use-openapi-validator.md     |   40 +
 ...1-create-perf-directory-with-k6-scripts.md |   40 +
 .../7.4.2-document-performance-benchmarks.md  |   40 +
 docs/stories/phase7/7.5.1-create-readmemd.md  |   40 +
 .../phase7/7.5.2-create-docsarchitecturemd.md |   40 +
 .../7.5.3-create-docsextension-pointsmd.md    |   40 +
 docs/stories/phase7/7.5.4-create-docsapimd.md |   40 +
 .../phase7/7.5.5-create-docsoperationsmd.md   |   40 +
 .../stories/phase7/7.5.6-add-code-examples.md |   40 +
 .../7.6.1-update-githubworkflowsciyml.md      |   40 +
 .../phase7/7.6.2-add-release-workflow.md      |   40 +
 .../phase7/7.6.3-add-security-scanning.md     |   40 +
 .../7.7.1-create-multi-stage-dockerfile.md    |   52 +
 ...reate-docker-composeyml-for-development.md |   40 +
 ...te-docker-composeprodyml-for-production.md |   40 +
 .../7.7.4-add-health-checks-to-dockerfile.md  |   40 +
 ...cument-docker-usage-in-docsdeploymentmd.md |   40 +
 ...7.8.1-create-docsdeploymentkubernetesmd.md |   40 +
 .../7.8.2-create-docsdeploymentdockermd.md    |   40 +
 .../7.8.3-create-docsdeploymentcloudmd.md     |   40 +
 ...7.9.1-create-makefile-with-common-tasks.md |   51 +
 .../phase7/7.9.2-add-development-scripts.md   |   40 +
 ...te-envexample-with-all-config-variables.md |   40 +
 .../7.9.4-add-pre-commit-hooks-optional.md    |   40 +
 .../8.1.1-install-githubcomcoreosgo-oidc.md   |   40 +
 .../phase8/8.1.2-implement-oidc-provider.md   |   40 +
 .../phase8/8.1.3-add-oidc-client-support.md   |   40 +
 ...8.1.4-document-oidc-setup-in-docsauthmd.md |   40 +
 .../8.2.1-install-githubcom99designsgqlgen.md |   40 +
 .../phase8/8.2.2-create-graphql-schema.md     |   40 +
 .../phase8/8.2.3-implement-resolvers.md       |   40 +
 ...8.2.4-add-graphql-endpoint-post-graphql.md |   40 +
 ....3.1-add-requestresponse-transformation.md |   40 +
 .../8.3.2-add-api-key-authentication.md       |   40 +
 .../phase8/8.3.3-add-request-routing-rules.md |   40 +
 .../8.3.4-add-api-versioning-support.md       |   40 +
 .../8.4.1-create-modulesnotification.md       |   40 +
 .../phase8/8.4.2-create-modulesanalytics.md   |   40 +
 .../8.5.1-add-database-query-caching.md       |   40 +
 .../phase8/8.5.2-optimize-n1-queries.md       |   40 +
 .../8.5.3-add-response-caching-redis.md       |   40 +
 ...lement-connection-pooling-optimizations.md |   40 +
 ....5.5-add-database-read-replicas-support.md |   40 +
 .../phase8/8.6.1-install-i18n-library.md      |   40 +
 .../phase8/8.6.2-add-locale-detection.md      |   40 +
 .../phase8/8.6.3-create-message-catalogs.md   |   40 +
 ...-translation-support-for-error-messages.md |   40 +
 .../8.7.1-code-review-and-refactoring.md      |   40 +
 docs/stories/phase8/8.7.10-di-setup.md        |   40 +
 docs/stories/phase8/8.7.11-di-container.md    |   40 +
 docs/stories/phase8/8.7.12-database-ent.md    |   40 +
 docs/stories/phase8/8.7.13-health--metrics.md |   40 +
 docs/stories/phase8/8.7.14-error-bus.md       |   40 +
 docs/stories/phase8/8.7.15-http-server.md     |   40 +
 docs/stories/phase8/8.7.16-opentelemetry.md   |   40 +
 .../phase8/8.7.17-jwt-authentication.md       |   40 +
 .../phase8/8.7.18-identity-management.md      |   40 +
 .../phase8/8.7.19-roles--permissions.md       |   40 +
 docs/stories/phase8/8.7.2-bug-fixes.md        |   40 +
 .../phase8/8.7.20-authorization-middleware.md |   40 +
 docs/stories/phase8/8.7.21-audit-logging.md   |   40 +
 .../stories/phase8/8.7.22-module-interface.md |   40 +
 docs/stories/phase8/8.7.23-static-registry.md |   40 +
 .../phase8/8.7.24-permission-generation.md    |   40 +
 docs/stories/phase8/8.7.25-module-loader.md   |   40 +
 .../phase8/8.7.26-module-initialization.md    |   40 +
 .../phase8/8.7.27-blog-module-structure.md    |   40 +
 docs/stories/phase8/8.7.28-domain-model.md    |   40 +
 .../phase8/8.7.29-repository--service.md      |   40 +
 .../phase8/8.7.3-performance-profiling.md     |   40 +
 docs/stories/phase8/8.7.30-api-handlers.md    |   40 +
 .../phase8/8.7.31-integration-tests.md        |   40 +
 docs/stories/phase8/8.7.32-cache-redis.md     |   40 +
 docs/stories/phase8/8.7.33-event-bus.md       |   40 +
 docs/stories/phase8/8.7.34-blob-storage.md    |   40 +
 .../phase8/8.7.35-email-notification.md       |   40 +
 docs/stories/phase8/8.7.36-schedulerjobs.md   |   40 +
 .../phase8/8.7.37-multi-tenancy-optional.md   |   40 +
 docs/stories/phase8/8.7.38-opentelemetry.md   |   40 +
 .../phase8/8.7.39-sentry-integration.md       |   40 +
 docs/stories/phase8/8.7.4-security-audit.md   |   40 +
 .../stories/phase8/8.7.40-enhanced-logging.md |   40 +
 .../phase8/8.7.41-prometheus-metrics.md       |   40 +
 .../phase8/8.7.42-grafana-dashboards.md       |   40 +
 docs/stories/phase8/8.7.43-rate-limiting.md   |   40 +
 .../phase8/8.7.44-security-hardening.md       |   40 +
 .../phase8/8.7.45-unit-tests-80-coverage.md   |   40 +
 .../phase8/8.7.46-integration-tests.md        |   40 +
 docs/stories/phase8/8.7.47-documentation.md   |   40 +
 docs/stories/phase8/8.7.48-cicd-pipeline.md   |   40 +
 docs/stories/phase8/8.7.49-docker-images.md   |   40 +
 .../phase8/8.7.5-documentation-review.md      |   40 +
 .../phase8/8.7.50-deployment-guides.md        |   40 +
 docs/stories/phase8/8.7.51-oidc-support.md    |   40 +
 docs/stories/phase8/8.7.52-graphql-api.md     |   40 +
 .../phase8/8.7.53-additional-modules.md       |   40 +
 .../phase8/8.7.54-performance-optimization.md |   40 +
 .../phase8/8.7.6-repository-structure.md      |   40 +
 .../phase8/8.7.7-configuration-system.md      |   40 +
 .../phase8/8.7.8-logging-foundation.md        |   40 +
 docs/stories/phase8/8.7.9-basic-cicd.md       |   40 +
 329 files changed, 16858 insertions(+)
 create mode 100644 .cursor/rules/golang.md
 create mode 100644 docs/adr/0001-go-module-path.md
 create mode 100644 docs/adr/0002-go-version.md
 create mode 100644 docs/adr/0003-dependency-injection-framework.md
 create mode 100644 docs/adr/0004-configuration-management.md
 create mode 100644 docs/adr/0005-logging-framework.md
 create mode 100644 docs/adr/0006-http-framework.md
 create mode 100644 docs/adr/0007-project-directory-structure.md
 create mode 100644 docs/adr/0008-error-handling-strategy.md
 create mode 100644 docs/adr/0009-context-key-types.md
 create mode 100644 docs/adr/0010-ci-cd-platform.md
 create mode 100644 docs/adr/0011-code-generation-tools.md
 create mode 100644 docs/adr/0012-logger-interface-design.md
 create mode 100644 docs/adr/0013-database-orm.md
 create mode 100644 docs/adr/0014-health-check-implementation.md
 create mode 100644 docs/adr/0015-error-bus-implementation.md
 create mode 100644 docs/adr/0016-opentelemetry-observability.md
 create mode 100644 docs/adr/0017-jwt-token-strategy.md
 create mode 100644 docs/adr/0018-password-hashing.md
 create mode 100644 docs/adr/0019-permission-dsl-format.md
 create mode 100644 docs/adr/0020-audit-logging-storage.md
 create mode 100644 docs/adr/0021-module-loading-strategy.md
 create mode 100644 docs/adr/0022-cache-implementation.md
 create mode 100644 docs/adr/0023-event-bus-implementation.md
 create mode 100644 docs/adr/0024-job-scheduler.md
 create mode 100644 docs/adr/0025-multitenancy-model.md
 create mode 100644 docs/adr/0026-error-reporting-service.md
 create mode 100644 docs/adr/0027-rate-limiting-strategy.md
 create mode 100644 docs/adr/0028-testing-strategy.md
 create mode 100644 docs/adr/README.md
 create mode 100644 docs/plan.md
 create mode 100644 docs/playbook.md
 create mode 100644 docs/requirements.md
 create mode 100644 docs/stories/COMPLETE_TASK_LIST.md
 create mode 100644 docs/stories/README.md
 create mode 100644 docs/stories/TASK_TEMPLATE.md
 create mode 100644 docs/stories/generate_tasks.py
 create mode 100644 docs/stories/phase0/0.1.1-initialize-go-module-go-mod-init-githubcomyourorgp.md
 create mode 100644 docs/stories/phase0/0.1.1-initialize-go-module.md
 create mode 100644 docs/stories/phase0/0.1.2-create-directory-structure.md
 create mode 100644 docs/stories/phase0/0.1.3-add-gitignore-for-go-projects.md
 create mode 100644 docs/stories/phase0/0.1.3-add-gitignore.md
 create mode 100644 docs/stories/phase0/0.1.4-create-initial-readme.md
 create mode 100644 docs/stories/phase0/0.1.4-create-initial-readmemd-with-project-overview.md
 create mode 100644 docs/stories/phase0/0.2.1-install-config-dependencies.md
 create mode 100644 docs/stories/phase0/0.2.1-install-githubcomspf13viper-and-githubcomspf13cobr.md
 create mode 100644 docs/stories/phase0/0.2.2-create-config-interface.md
 create mode 100644 docs/stories/phase0/0.2.2-create-pkgconfigconfiggo-interface.md
 create mode 100644 docs/stories/phase0/0.2.3-implement-config-loader.md
 create mode 100644 docs/stories/phase0/0.2.3-implement-internalconfigconfiggo-using-viper.md
 create mode 100644 docs/stories/phase0/0.2.4-create-configdefaultyaml-with-basic-structure.md
 create mode 100644 docs/stories/phase0/0.2.4-create-configuration-files.md
 create mode 100644 docs/stories/phase0/0.2.5-add-internalconfigloadergo-with-loadconfig-functio.md
 create mode 100644 docs/stories/phase0/0.3.1-install-gouberorgzap.md
 create mode 100644 docs/stories/phase0/0.3.1-install-logging-dependencies.md
 create mode 100644 docs/stories/phase0/0.3.2-create-pkgloggerloggergo-interface.md
 create mode 100644 docs/stories/phase0/0.3.3-implement-internalloggerzap_loggergo.md
 create mode 100644 docs/stories/phase0/0.3.4-add-request-id-middleware-helper-gin-middleware.md
 create mode 100644 docs/stories/phase0/0.4.1-create-githubworkflowsciyml.md
 create mode 100644 docs/stories/phase0/0.4.2-add-makefile-with-common-commands.md
 create mode 100644 docs/stories/phase0/0.5.1-install-gouberorgfx.md
 create mode 100644 docs/stories/phase0/0.5.2-create-internaldicontainergo.md
 create mode 100644 docs/stories/phase0/0.5.3-create-cmdplatformmaingo-skeleton.md
 create mode 100644 docs/stories/phase0/README.md
 create mode 100644 docs/stories/phase1/1.1.1-extend-internaldicontainergo.md
 create mode 100644 docs/stories/phase1/1.1.2-create-internaldiprovidersgo.md
 create mode 100644 docs/stories/phase1/1.1.3-add-internaldicore_modulego.md
 create mode 100644 docs/stories/phase1/1.2.1-install-entgoioentcmdent.md
 create mode 100644 docs/stories/phase1/1.2.2-initialize-ent-schema.md
 create mode 100644 docs/stories/phase1/1.2.3-define-core-entities-in-internalentschema.md
 create mode 100644 docs/stories/phase1/1.2.4-generate-ent-code-go-generate-internalent.md
 create mode 100644 docs/stories/phase1/1.2.5-create-internalinfradatabaseclientgo.md
 create mode 100644 docs/stories/phase1/1.2.6-add-database-config-to-configdefaultyaml.md
 create mode 100644 docs/stories/phase1/1.3.1-install-githubcomprometheusclient_golangprometheus.md
 create mode 100644 docs/stories/phase1/1.3.2-install-githubcomheptiolabshealthcheck-optional-or.md
 create mode 100644 docs/stories/phase1/1.3.3-create-pkghealthhealthgo-interface.md
 create mode 100644 docs/stories/phase1/1.3.4-implement-internalhealthregistrygo.md
 create mode 100644 docs/stories/phase1/1.3.5-create-internalmetricsmetricsgo.md
 create mode 100644 docs/stories/phase1/1.3.6-add-metrics-endpoint-prometheus-format.md
 create mode 100644 docs/stories/phase1/1.3.7-register-endpoints-in-main-http-router.md
 create mode 100644 docs/stories/phase1/1.4.1-create-pkgerrorbuserrorbusgo-interface.md
 create mode 100644 docs/stories/phase1/1.4.2-implement-internalerrorbuschannel_busgo.md
 create mode 100644 docs/stories/phase1/1.4.3-add-panic-recovery-middleware-that-publishes-to-er.md
 create mode 100644 docs/stories/phase1/1.4.4-register-error-bus-in-di-container.md
 create mode 100644 docs/stories/phase1/1.5.1-install-githubcomgin-gonicgin.md
 create mode 100644 docs/stories/phase1/1.5.2-create-internalserverservergo.md
 create mode 100644 docs/stories/phase1/1.5.3-wire-http-server-into-fx-lifecycle.md
 create mode 100644 docs/stories/phase1/1.5.4-update-cmdplatformmaingo-to-use-fx-lifecycle.md
 create mode 100644 docs/stories/phase1/1.6.1-install-opentelemetry-packages.md
 create mode 100644 docs/stories/phase1/1.6.2-create-internalobservabilitytracergo.md
 create mode 100644 docs/stories/phase1/1.6.3-add-http-instrumentation-middleware.md
 create mode 100644 docs/stories/phase1/1.6.4-add-trace-context-propagation-to-requests.md
 create mode 100644 docs/stories/phase2/2.1.1-install-githubcomgolang-jwtjwtv5.md
 create mode 100644 docs/stories/phase2/2.1.2-create-pkgauthauthgo-interfaces.md
 create mode 100644 docs/stories/phase2/2.1.3-implement-internalauthjwt_authgo.md
 create mode 100644 docs/stories/phase2/2.1.4-create-internalauthmiddlewarego.md
 create mode 100644 docs/stories/phase2/2.1.5-add-login-endpoint-post-apiv1authlogin.md
 create mode 100644 docs/stories/phase2/2.1.6-add-refresh-endpoint-post-apiv1authrefresh.md
 create mode 100644 docs/stories/phase2/2.2.1-create-pkgidentityidentitygo-interfaces.md
 create mode 100644 docs/stories/phase2/2.2.2-implement-internalidentityuser_repogo-using-ent.md
 create mode 100644 docs/stories/phase2/2.2.3-implement-internalidentityuser_servicego.md
 create mode 100644 docs/stories/phase2/2.2.4-add-endpoints.md
 create mode 100644 docs/stories/phase2/2.3.1-create-pkgpermpermgo.md
 create mode 100644 docs/stories/phase2/2.3.2-create-pkgpermresolvergo-interface.md
 create mode 100644 docs/stories/phase2/2.3.3-implement-internalpermin_memory_resolvergo.md
 create mode 100644 docs/stories/phase2/2.3.4-create-pkgauthauthzgo-interface.md
 create mode 100644 docs/stories/phase2/2.3.5-implement-internalauthrbac_authorizergo.md
 create mode 100644 docs/stories/phase2/2.3.6-create-authorization-middleware.md
 create mode 100644 docs/stories/phase2/2.4.1-create-internalidentityrole_repogo.md
 create mode 100644 docs/stories/phase2/2.4.2-add-endpoints.md
 create mode 100644 docs/stories/phase2/2.5.1-create-pkgauditauditgo-interface.md
 create mode 100644 docs/stories/phase2/2.5.2-implement-internalauditent_auditorgo.md
 create mode 100644 docs/stories/phase2/2.5.3-add-audit-middleware.md
 create mode 100644 docs/stories/phase2/2.5.4-integrate-with-auth-endpoints.md
 create mode 100644 docs/stories/phase2/2.6.1-create-internalseedseedgo.md
 create mode 100644 docs/stories/phase3/3.1.1-create-pkgmodulemodulego.md
 create mode 100644 docs/stories/phase3/3.1.2-create-pkgmodulemanifestgo.md
 create mode 100644 docs/stories/phase3/3.1.3-define-moduleyaml-schema-used-for-code-generation.md
 create mode 100644 docs/stories/phase3/3.2.1-create-internalregistryregistrygo.md
 create mode 100644 docs/stories/phase3/3.2.2-add-registration-validation.md
 create mode 100644 docs/stories/phase3/3.3.1-create-scriptsgenerate-permissionsgo.md
 create mode 100644 docs/stories/phase3/3.3.2-add-gogenerate-directive-to-pkgpermpermgo.md
 create mode 100644 docs/stories/phase3/3.3.3-update-makefile-with-make-generate-command.md
 create mode 100644 docs/stories/phase3/3.4.1-create-internalpluginloaderloadergo.md
 create mode 100644 docs/stories/phase3/3.4.2-implement-internalpluginloaderstatic_loadergo.md
 create mode 100644 docs/stories/phase3/3.4.3-implement-internalpluginloaderplugin_loadergo-opti.md
 create mode 100644 docs/stories/phase3/3.5.1-create-internalmoduleinitializergo.md
 create mode 100644 docs/stories/phase3/3.5.2-run-migrations.md
 create mode 100644 docs/stories/phase3/3.6.1-extend-pkgmodulemodulego.md
 create mode 100644 docs/stories/phase3/3.6.2-integrate-with-fxlifecycle.md
 create mode 100644 docs/stories/phase3/3.7.1-create-cmdplatformctlmaingo.md
 create mode 100644 docs/stories/phase3/3.7.2-add-to-makefile-make-install-cli.md
 create mode 100644 docs/stories/phase4/4.1.1-create-modulesblog-directory.md
 create mode 100644 docs/stories/phase4/4.1.2-initialize-gomod.md
 create mode 100644 docs/stories/phase4/4.2.1-create-modulesblogmoduleyaml.md
 create mode 100644 docs/stories/phase4/4.3.1-create-modulesbloginternaldomainpostgo.md
 create mode 100644 docs/stories/phase4/4.3.2-create-ent-schema-modulesbloginternalentschemapost.md
 create mode 100644 docs/stories/phase4/4.3.3-generate-ent-code-for-blog-module.md
 create mode 100644 docs/stories/phase4/4.4.1-create-modulesbloginternaldomainpost_repogo.md
 create mode 100644 docs/stories/phase4/4.4.2-implement-using-ent-client-shared-from-core.md
 create mode 100644 docs/stories/phase4/4.5.1-create-modulesbloginternalservicepost_servicego.md
 create mode 100644 docs/stories/phase4/4.6.1-create-modulesbloginternalapihandlergo.md
 create mode 100644 docs/stories/phase4/4.6.2-use-authorization-middleware.md
 create mode 100644 docs/stories/phase4/4.6.3-register-handlers-in-modules-init.md
 create mode 100644 docs/stories/phase4/4.7.1-create-modulesblogpkgmodulego.md
 create mode 100644 docs/stories/phase4/4.8.1-update-main-gomod-to-include-blog-module.md
 create mode 100644 docs/stories/phase4/4.8.2-import-blog-module-in-cmdplatformmaingo.md
 create mode 100644 docs/stories/phase4/4.8.3-run-permission-generation-make-generate.md
 create mode 100644 docs/stories/phase4/4.8.4-verify-blog-permissions-are-generated.md
 create mode 100644 docs/stories/phase4/4.9.1-create-integration-test-modulesbloginternalapihand.md
 create mode 100644 docs/stories/phase4/4.9.2-add-unit-tests-for-service-and-repository.md
 create mode 100644 docs/stories/phase5/5.1.1-install-githubcomredisgo-redisv9.md
 create mode 100644 docs/stories/phase5/5.1.2-create-pkginfracachecachego-interface.md
 create mode 100644 docs/stories/phase5/5.1.3-implement-internalinfracacheredis_cachego.md
 create mode 100644 docs/stories/phase5/5.1.4-add-redis-config-to-configdefaultyaml.md
 create mode 100644 docs/stories/phase5/5.1.5-register-in-di-container.md
 create mode 100644 docs/stories/phase5/5.1.6-add-cache-middleware-for-selected-routes-optional.md
 create mode 100644 docs/stories/phase5/5.2.1-create-pkgeventbuseventbusgo-interface.md
 create mode 100644 docs/stories/phase5/5.2.2-implement-internalinfrabusinprocess_busgo.md
 create mode 100644 docs/stories/phase5/5.2.3-implement-internalinfrabuskafka_busgo.md
 create mode 100644 docs/stories/phase5/5.2.4-add-kafka-config-to-configdefaultyaml.md
 create mode 100644 docs/stories/phase5/5.2.5-register-bus-in-di-container-switchable-via-config.md
 create mode 100644 docs/stories/phase5/5.2.6-add-core-events.md
 create mode 100644 docs/stories/phase5/5.3.1-install-githubcomawsaws-sdk-go-v2services3.md
 create mode 100644 docs/stories/phase5/5.3.2-create-pkginfrablobblobgo-interface.md
 create mode 100644 docs/stories/phase5/5.3.3-implement-internalinfrablobs3_storego.md
 create mode 100644 docs/stories/phase5/5.3.4-add-s3-config-to-configdefaultyaml.md
 create mode 100644 docs/stories/phase5/5.3.5-register-in-di-container.md
 create mode 100644 docs/stories/phase5/5.3.6-add-file-upload-endpoint-post-apiv1filesupload.md
 create mode 100644 docs/stories/phase5/5.4.1-install-githubcomgo-mailmail.md
 create mode 100644 docs/stories/phase5/5.4.2-create-pkgnotificationnotificationgo-interface.md
 create mode 100644 docs/stories/phase5/5.4.3-implement-internalinfraemailsmtp_notifiergo.md
 create mode 100644 docs/stories/phase5/5.4.4-add-email-config-to-configdefaultyaml.md
 create mode 100644 docs/stories/phase5/5.4.5-integrate-with-identity-service.md
 create mode 100644 docs/stories/phase5/5.4.6-register-in-di-container.md
 create mode 100644 docs/stories/phase5/5.5.1-install-githubcomrobfigcronv3-and-githubcomhibiken.md
 create mode 100644 docs/stories/phase5/5.5.2-create-pkgschedulerschedulergo-interface.md
 create mode 100644 docs/stories/phase5/5.5.3-implement-internalinfraschedulerasynq_schedulergo.md
 create mode 100644 docs/stories/phase5/5.5.4-create-internalinfraschedulerjob_registrygo.md
 create mode 100644 docs/stories/phase5/5.5.5-add-example-jobs.md
 create mode 100644 docs/stories/phase5/5.5.6-add-job-monitoring-endpoint-get-apiv1jobsstatus.md
 create mode 100644 docs/stories/phase5/5.6.1-create-pkginfrasecretsecretgo-interface.md
 create mode 100644 docs/stories/phase5/5.6.2-implement-internalinfrasecretvault_storego-hashico.md
 create mode 100644 docs/stories/phase5/5.6.3-implement-internalinfrasecretaws_secretsgo-aws-sec.md
 create mode 100644 docs/stories/phase5/5.6.4-integrate-with-config-loader.md
 create mode 100644 docs/stories/phase5/5.6.5-register-in-di-container-optional-via-config.md
 create mode 100644 docs/stories/phase5/5.7.1-create-pkgtenanttenantgo-interface.md
 create mode 100644 docs/stories/phase5/5.7.2-implement-internaltenantresolvergo.md
 create mode 100644 docs/stories/phase5/5.7.3-add-tenant-middleware.md
 create mode 100644 docs/stories/phase5/5.7.4-update-ent-queries-to-filter-by-tenant_id.md
 create mode 100644 docs/stories/phase5/5.7.5-update-user-entity-to-include-tenant_id.md
 create mode 100644 docs/stories/phase6/6.1.1-complete-opentelemetry-setup.md
 create mode 100644 docs/stories/phase6/6.1.2-create-custom-spans.md
 create mode 100644 docs/stories/phase6/6.1.3-add-trace-context-propagation.md
 create mode 100644 docs/stories/phase6/6.2.1-install-githubcomgetsentrysentry-go.md
 create mode 100644 docs/stories/phase6/6.2.2-integrate-with-error-bus.md
 create mode 100644 docs/stories/phase6/6.2.3-add-sentry-middleware.md
 create mode 100644 docs/stories/phase6/6.2.4-configure-sentry-dsn-via-config.md
 create mode 100644 docs/stories/phase6/6.3.1-add-request-correlation.md
 create mode 100644 docs/stories/phase6/6.3.2-add-structured-fields.md
 create mode 100644 docs/stories/phase6/6.3.3-create-log-aggregation-config.md
 create mode 100644 docs/stories/phase6/6.4.1-add-more-metrics.md
 create mode 100644 docs/stories/phase6/6.4.2-create-metric-labels.md
 create mode 100644 docs/stories/phase6/6.5.1-create-opsgrafanadashboards.md
 create mode 100644 docs/stories/phase6/6.5.2-document-dashboard-setup-in-docsoperationsmd.md
 create mode 100644 docs/stories/phase6/6.6.1-install-githubcomululelimiterv3.md
 create mode 100644 docs/stories/phase6/6.6.2-create-rate-limit-middleware.md
 create mode 100644 docs/stories/phase6/6.6.3-add-rate-limit-config.md
 create mode 100644 docs/stories/phase6/6.6.4-return-x-ratelimit--headers.md
 create mode 100644 docs/stories/phase6/6.7.1-add-security-headers-middleware.md
 create mode 100644 docs/stories/phase6/6.7.2-add-request-size-limits.md
 create mode 100644 docs/stories/phase6/6.7.3-add-input-validation.md
 create mode 100644 docs/stories/phase6/6.7.4-add-sql-injection-protection.md
 create mode 100644 docs/stories/phase6/6.8.1-add-database-connection-pooling.md
 create mode 100644 docs/stories/phase6/6.8.2-add-query-optimization.md
 create mode 100644 docs/stories/phase6/6.8.3-add-response-compression.md
 create mode 100644 docs/stories/phase6/6.8.4-add-caching-strategy.md
 create mode 100644 docs/stories/phase7/7.1.1-achieve-80-code-coverage-for-core-modules.md
 create mode 100644 docs/stories/phase7/7.1.2-use-githubcomstretchrtestify-for-assertions.md
 create mode 100644 docs/stories/phase7/7.1.3-use-githubcomgolangmock-or-mockery-for-mocks.md
 create mode 100644 docs/stories/phase7/7.1.4-add-test-helpers.md
 create mode 100644 docs/stories/phase7/7.2.1-install-githubcomtestcontainerstestcontainers-go.md
 create mode 100644 docs/stories/phase7/7.2.2-create-integration-test-suite.md
 create mode 100644 docs/stories/phase7/7.2.3-test-scenarios.md
 create mode 100644 docs/stories/phase7/7.2.4-create-docker-composetestyml.md
 create mode 100644 docs/stories/phase7/7.2.5-add-test-tags-gobuild-integration.md
 create mode 100644 docs/stories/phase7/7.3.1-install-githubcompact-foundationpact-go-optional.md
 create mode 100644 docs/stories/phase7/7.3.2-create-api-contract-tests.md
 create mode 100644 docs/stories/phase7/7.3.3-use-openapi-validator.md
 create mode 100644 docs/stories/phase7/7.4.1-create-perf-directory-with-k6-scripts.md
 create mode 100644 docs/stories/phase7/7.4.2-document-performance-benchmarks.md
 create mode 100644 docs/stories/phase7/7.5.1-create-readmemd.md
 create mode 100644 docs/stories/phase7/7.5.2-create-docsarchitecturemd.md
 create mode 100644 docs/stories/phase7/7.5.3-create-docsextension-pointsmd.md
 create mode 100644 docs/stories/phase7/7.5.4-create-docsapimd.md
 create mode 100644 docs/stories/phase7/7.5.5-create-docsoperationsmd.md
 create mode 100644 docs/stories/phase7/7.5.6-add-code-examples.md
 create mode 100644 docs/stories/phase7/7.6.1-update-githubworkflowsciyml.md
 create mode 100644 docs/stories/phase7/7.6.2-add-release-workflow.md
 create mode 100644 docs/stories/phase7/7.6.3-add-security-scanning.md
 create mode 100644 docs/stories/phase7/7.7.1-create-multi-stage-dockerfile.md
 create mode 100644 docs/stories/phase7/7.7.2-create-docker-composeyml-for-development.md
 create mode 100644 docs/stories/phase7/7.7.3-create-docker-composeprodyml-for-production.md
 create mode 100644 docs/stories/phase7/7.7.4-add-health-checks-to-dockerfile.md
 create mode 100644 docs/stories/phase7/7.7.5-document-docker-usage-in-docsdeploymentmd.md
 create mode 100644 docs/stories/phase7/7.8.1-create-docsdeploymentkubernetesmd.md
 create mode 100644 docs/stories/phase7/7.8.2-create-docsdeploymentdockermd.md
 create mode 100644 docs/stories/phase7/7.8.3-create-docsdeploymentcloudmd.md
 create mode 100644 docs/stories/phase7/7.9.1-create-makefile-with-common-tasks.md
 create mode 100644 docs/stories/phase7/7.9.2-add-development-scripts.md
 create mode 100644 docs/stories/phase7/7.9.3-create-envexample-with-all-config-variables.md
 create mode 100644 docs/stories/phase7/7.9.4-add-pre-commit-hooks-optional.md
 create mode 100644 docs/stories/phase8/8.1.1-install-githubcomcoreosgo-oidc.md
 create mode 100644 docs/stories/phase8/8.1.2-implement-oidc-provider.md
 create mode 100644 docs/stories/phase8/8.1.3-add-oidc-client-support.md
 create mode 100644 docs/stories/phase8/8.1.4-document-oidc-setup-in-docsauthmd.md
 create mode 100644 docs/stories/phase8/8.2.1-install-githubcom99designsgqlgen.md
 create mode 100644 docs/stories/phase8/8.2.2-create-graphql-schema.md
 create mode 100644 docs/stories/phase8/8.2.3-implement-resolvers.md
 create mode 100644 docs/stories/phase8/8.2.4-add-graphql-endpoint-post-graphql.md
 create mode 100644 docs/stories/phase8/8.3.1-add-requestresponse-transformation.md
 create mode 100644 docs/stories/phase8/8.3.2-add-api-key-authentication.md
 create mode 100644 docs/stories/phase8/8.3.3-add-request-routing-rules.md
 create mode 100644 docs/stories/phase8/8.3.4-add-api-versioning-support.md
 create mode 100644 docs/stories/phase8/8.4.1-create-modulesnotification.md
 create mode 100644 docs/stories/phase8/8.4.2-create-modulesanalytics.md
 create mode 100644 docs/stories/phase8/8.5.1-add-database-query-caching.md
 create mode 100644 docs/stories/phase8/8.5.2-optimize-n1-queries.md
 create mode 100644 docs/stories/phase8/8.5.3-add-response-caching-redis.md
 create mode 100644 docs/stories/phase8/8.5.4-implement-connection-pooling-optimizations.md
 create mode 100644 docs/stories/phase8/8.5.5-add-database-read-replicas-support.md
 create mode 100644 docs/stories/phase8/8.6.1-install-i18n-library.md
 create mode 100644 docs/stories/phase8/8.6.2-add-locale-detection.md
 create mode 100644 docs/stories/phase8/8.6.3-create-message-catalogs.md
 create mode 100644 docs/stories/phase8/8.6.4-add-translation-support-for-error-messages.md
 create mode 100644 docs/stories/phase8/8.7.1-code-review-and-refactoring.md
 create mode 100644 docs/stories/phase8/8.7.10-di-setup.md
 create mode 100644 docs/stories/phase8/8.7.11-di-container.md
 create mode 100644 docs/stories/phase8/8.7.12-database-ent.md
 create mode 100644 docs/stories/phase8/8.7.13-health--metrics.md
 create mode 100644 docs/stories/phase8/8.7.14-error-bus.md
 create mode 100644 docs/stories/phase8/8.7.15-http-server.md
 create mode 100644 docs/stories/phase8/8.7.16-opentelemetry.md
 create mode 100644 docs/stories/phase8/8.7.17-jwt-authentication.md
 create mode 100644 docs/stories/phase8/8.7.18-identity-management.md
 create mode 100644 docs/stories/phase8/8.7.19-roles--permissions.md
 create mode 100644 docs/stories/phase8/8.7.2-bug-fixes.md
 create mode 100644 docs/stories/phase8/8.7.20-authorization-middleware.md
 create mode 100644 docs/stories/phase8/8.7.21-audit-logging.md
 create mode 100644 docs/stories/phase8/8.7.22-module-interface.md
 create mode 100644 docs/stories/phase8/8.7.23-static-registry.md
 create mode 100644 docs/stories/phase8/8.7.24-permission-generation.md
 create mode 100644 docs/stories/phase8/8.7.25-module-loader.md
 create mode 100644 docs/stories/phase8/8.7.26-module-initialization.md
 create mode 100644 docs/stories/phase8/8.7.27-blog-module-structure.md
 create mode 100644 docs/stories/phase8/8.7.28-domain-model.md
 create mode 100644 docs/stories/phase8/8.7.29-repository--service.md
 create mode 100644 docs/stories/phase8/8.7.3-performance-profiling.md
 create mode 100644 docs/stories/phase8/8.7.30-api-handlers.md
 create mode 100644 docs/stories/phase8/8.7.31-integration-tests.md
 create mode 100644 docs/stories/phase8/8.7.32-cache-redis.md
 create mode 100644 docs/stories/phase8/8.7.33-event-bus.md
 create mode 100644 docs/stories/phase8/8.7.34-blob-storage.md
 create mode 100644 docs/stories/phase8/8.7.35-email-notification.md
 create mode 100644 docs/stories/phase8/8.7.36-schedulerjobs.md
 create mode 100644 docs/stories/phase8/8.7.37-multi-tenancy-optional.md
 create mode 100644 docs/stories/phase8/8.7.38-opentelemetry.md
 create mode 100644 docs/stories/phase8/8.7.39-sentry-integration.md
 create mode 100644 docs/stories/phase8/8.7.4-security-audit.md
 create mode 100644 docs/stories/phase8/8.7.40-enhanced-logging.md
 create mode 100644 docs/stories/phase8/8.7.41-prometheus-metrics.md
 create mode 100644 docs/stories/phase8/8.7.42-grafana-dashboards.md
 create mode 100644 docs/stories/phase8/8.7.43-rate-limiting.md
 create mode 100644 docs/stories/phase8/8.7.44-security-hardening.md
 create mode 100644 docs/stories/phase8/8.7.45-unit-tests-80-coverage.md
 create mode 100644 docs/stories/phase8/8.7.46-integration-tests.md
 create mode 100644 docs/stories/phase8/8.7.47-documentation.md
 create mode 100644 docs/stories/phase8/8.7.48-cicd-pipeline.md
 create mode 100644 docs/stories/phase8/8.7.49-docker-images.md
 create mode 100644 docs/stories/phase8/8.7.5-documentation-review.md
 create mode 100644 docs/stories/phase8/8.7.50-deployment-guides.md
 create mode 100644 docs/stories/phase8/8.7.51-oidc-support.md
 create mode 100644 docs/stories/phase8/8.7.52-graphql-api.md
 create mode 100644 docs/stories/phase8/8.7.53-additional-modules.md
 create mode 100644 docs/stories/phase8/8.7.54-performance-optimization.md
 create mode 100644 docs/stories/phase8/8.7.6-repository-structure.md
 create mode 100644 docs/stories/phase8/8.7.7-configuration-system.md
 create mode 100644 docs/stories/phase8/8.7.8-logging-foundation.md
 create mode 100644 docs/stories/phase8/8.7.9-basic-cicd.md

diff --git a/.cursor/rules/golang.md b/.cursor/rules/golang.md
new file mode 100644
index 0000000..c4be26e
--- /dev/null
+++ b/.cursor/rules/golang.md
@@ -0,0 +1,95 @@
+You are an expert in Go, microservices architecture, and clean backend development practices. Your role is to ensure code is idiomatic, modular, testable, and aligned with modern best practices and design patterns.
+
+### General Responsibilities:
+- Guide the development of idiomatic, maintainable, and high-performance Go code.
+- Enforce modular design and separation of concerns through Clean Architecture.
+- Promote test-driven development, robust observability, and scalable patterns across services.
+
+### Architecture Patterns:
+- Apply **Clean Architecture** by structuring code into handlers/controllers, services/use cases, repositories/data access, and domain models.
+- Use **domain-driven design** principles where applicable.
+- Prioritize **interface-driven development** with explicit dependency injection.
+- Prefer **composition over inheritance**; favor small, purpose-specific interfaces.
+- Ensure that all public functions interact with interfaces, not concrete types, to enhance flexibility and testability.
+
+### Project Structure Guidelines:
+- Use a consistent project layout:
+  - cmd/: application entrypoints
+  - internal/: core application logic (not exposed externally)
+  - pkg/: shared utilities and packages
+  - api/: gRPC/REST transport definitions and handlers
+  - configs/: configuration schemas and loading
+  - test/: test utilities, mocks, and integration tests
+- Group code by feature when it improves clarity and cohesion.
+- Keep logic decoupled from framework-specific code.
+
+### Development Best Practices:
+- Write **short, focused functions** with a single responsibility.
+- Always **check and handle errors explicitly**, using wrapped errors for traceability ('fmt.Errorf("context: %w", err)').
+- Avoid **global state**; use constructor functions to inject dependencies.
+- Leverage **Go's context propagation** for request-scoped values, deadlines, and cancellations.
+- Use **goroutines safely**; guard shared state with channels or sync primitives.
+- **Defer closing resources** and handle them carefully to avoid leaks.
+
+### Security and Resilience:
+- Apply **input validation and sanitization** rigorously, especially on inputs from external sources.
+- Use secure defaults for **JWT, cookies**, and configuration settings.
+- Isolate sensitive operations with clear **permission boundaries**.
+- Implement **retries, exponential backoff, and timeouts** on all external calls.
+- Use **circuit breakers and rate limiting** for service protection.
+- Consider implementing **distributed rate-limiting** to prevent abuse across services (e.g., using Redis).
+
+### Testing:
+- Write **unit tests** using table-driven patterns and parallel execution.
+- **Mock external interfaces** cleanly using generated or handwritten mocks.
+- Separate **fast unit tests** from slower integration and E2E tests.
+- Ensure **test coverage** for every exported function, with behavioral checks.
+- Use tools like 'go test -cover' to ensure adequate test coverage.
+
+### Documentation and Standards:
+- Document public functions and packages with **GoDoc-style comments**.
+- Provide concise **READMEs** for services and libraries.
+- Maintain a 'CONTRIBUTING.md' and 'ARCHITECTURE.md' to guide team practices.
+- Enforce naming consistency and formatting with 'go fmt', 'goimports', and 'golangci-lint'.
+
+### Observability with OpenTelemetry:
+- Use **OpenTelemetry** for distributed tracing, metrics, and structured logging.
+- Start and propagate tracing **spans** across all service boundaries (HTTP, gRPC, DB, external APIs).
+- Always attach 'context.Context' to spans, logs, and metric exports.
+- Use **otel.Tracer** for creating spans and **otel.Meter** for collecting metrics.
+- Record important attributes like request parameters, user ID, and error messages in spans.
+- Use **log correlation** by injecting trace IDs into structured logs.
+- Export data to **OpenTelemetry Collector**, **Jaeger**, or **Prometheus**.
+
+### Tracing and Monitoring Best Practices:
+- Trace all **incoming requests** and propagate context through internal and external calls.
+- Use **middleware** to instrument HTTP and gRPC endpoints automatically.
+- Annotate slow, critical, or error-prone paths with **custom spans**.
+- Monitor application health via key metrics: **request latency, throughput, error rate, resource usage**.
+- Define **SLIs** (e.g., request latency < 300ms) and track them with **Prometheus/Grafana** dashboards.
+- Alert on key conditions (e.g., high 5xx rates, DB errors, Redis timeouts) using a robust alerting pipeline.
+- Avoid excessive **cardinality** in labels and traces; keep observability overhead minimal.
+- Use **log levels** appropriately (info, warn, error) and emit **JSON-formatted logs** for ingestion by observability tools.
+- Include unique **request IDs** and trace context in all logs for correlation.
+
+### Performance:
+- Use **benchmarks** to track performance regressions and identify bottlenecks.
+- Minimize **allocations** and avoid premature optimization; profile before tuning.
+- Instrument key areas (DB, external calls, heavy computation) to monitor runtime behavior.
+
+### Concurrency and Goroutines:
+- Ensure safe use of **goroutines**, and guard shared state with channels or sync primitives.
+- Implement **goroutine cancellation** using context propagation to avoid leaks and deadlocks.
+
+### Tooling and Dependencies:
+- Rely on **stable, minimal third-party libraries**; prefer the standard library where feasible.
+- Use **Go modules** for dependency management and reproducibility.
+- Version-lock dependencies for deterministic builds.
+- Integrate **linting, testing, and security checks** in CI pipelines.
+
+### Key Conventions:
+1. Prioritize **readability, simplicity, and maintainability**.
+2. Design for **change**: isolate business logic and minimize framework lock-in.
+3. Emphasize clear **boundaries** and **dependency inversion**.
+4. Ensure all behavior is **observable, testable, and documented**.
+5. **Automate workflows** for testing, building, and deployment.
\ No newline at end of file
diff --git a/docs/adr/0001-go-module-path.md b/docs/adr/0001-go-module-path.md
new file mode 100644
index 0000000..7b2c11f
--- /dev/null
+++ b/docs/adr/0001-go-module-path.md
@@ -0,0 +1,37 @@
+# ADR-0001: Go Module Path
+
+## Status
+Accepted
+
+## Context
+The project needs a Go module path that uniquely identifies the platform. This path will be used:
+- In `go.mod` file
+- For importing packages within the project
+- For module dependencies
+- For future module publishing
+
+## Decision
+Use `git.dcentral.systems/toolz/goplt` as the Go module path.
+
+**Rationale:**
+- Matches the organization's Git hosting structure
+- Follows Go module naming conventions
+- Clearly identifies the project as a Go platform tool
+- Prevents naming conflicts with other modules
+
+## Consequences
+
+### Positive
+- Clear, descriptive module path
+- Aligns with organization's infrastructure
+- Easy to identify in dependency graphs
+
+### Negative
+- Requires access to `git.dcentral.systems` for module resolution
+- May need to configure GOPRIVATE/GONOPROXY if using private registry
+
+### Implementation Notes
+- Initialize module: `go mod init git.dcentral.systems/toolz/goplt`
+- Update all import paths in code to use this module path
+- Configure `.git/config` or Go environment variables if needed for private module access
+
diff --git a/docs/adr/0002-go-version.md b/docs/adr/0002-go-version.md
new file mode 100644
index 0000000..4d1bf63
--- /dev/null
+++ b/docs/adr/0002-go-version.md
@@ -0,0 +1,39 @@
+# ADR-0002: Go Version
+
+## Status
+Accepted
+
+## Context
+Go releases new versions regularly with new features, performance improvements, and security fixes. We need to choose a Go version that:
+- Provides necessary features for the platform
+- Has good ecosystem support
+- Is stable and production-ready
+- Supports required tooling (plugins, etc.)
+
+## Decision
+Use **Go 1.24.3** as the minimum required version for the platform.
+
+**Rationale:**
+- Latest stable version available
+- Provides all required features for the platform
+- Ensures compatibility with modern Go tooling
+- Supports all planned features (modules, plugins, generics)
+
+## Consequences
+
+### Positive
+- Access to latest Go features and performance improvements
+- Better security with latest patches
+- Modern tooling support
+
+### Negative
+- Requires developers to have Go 1.24.3+ installed
+- CI/CD must use compatible Go version
+- May limit compatibility with some older dependencies (if any)
+
+### Implementation Notes
+- Specify in `go.mod`: `go 1.24`
+- Document in `README.md` and CI configuration
+- Update `.github/workflows/ci.yml` to use `actions/setup-go@v5` with version `1.24.3`
+- Add version check script if needed
+
diff --git a/docs/adr/0003-dependency-injection-framework.md b/docs/adr/0003-dependency-injection-framework.md
new file mode 100644
index 0000000..eb3863f
--- /dev/null
+++ b/docs/adr/0003-dependency-injection-framework.md
@@ -0,0 +1,49 @@
+# ADR-0003: Dependency Injection Framework
+
+## Status
+Accepted
+
+## Context
+The platform requires dependency injection to:
+- Manage service lifecycle
+- Wire dependencies between components
+- Support module system initialization
+- Handle graceful shutdown
+- Provide testability through dependency substitution
+
+Options considered:
+1. **uber-go/fx** - Runtime dependency injection with lifecycle management
+2. **uber-go/dig** - Compile-time dependency injection
+3. **Manual constructor injection** - No framework, explicit wiring
+
+## Decision
+Use **uber-go/fx** (v1.23.0+) as the dependency injection framework.
+
+**Rationale:**
+- Provides lifecycle management (OnStart/OnStop hooks) crucial for services
+- Supports module-based architecture through fx.Option composition
+- Runtime dependency resolution with compile-time type safety
+- Excellent for modular monolith architecture
+- Well-documented and actively maintained
+- Used by major Go projects (Uber, etc.)
+
+## Consequences
+
+### Positive
+- Clean lifecycle management for services
+- Easy module composition via fx.Option
+- Graceful shutdown handling built-in
+- Test-friendly with fx.Options for test overrides
+
+### Negative
+- Runtime reflection overhead (minimal)
+- Learning curve for developers unfamiliar with fx
+- Slightly more complex error messages on dependency resolution failures
+
+### Implementation Notes
+- Install: `go get go.uber.org/fx@v1.23.0`
+- Create `internal/di/container.go` with fx.New()
+- Use fx.Provide() for service registration
+- Use fx.Invoke() for initialization tasks
+- Leverage fx.Lifecycle for service startup/shutdown
+
diff --git a/docs/adr/0004-configuration-management.md b/docs/adr/0004-configuration-management.md
new file mode 100644
index 0000000..d815e47
--- /dev/null
+++ b/docs/adr/0004-configuration-management.md
@@ -0,0 +1,50 @@
+# ADR-0004: Configuration Management Library
+
+## Status
+Accepted
+
+## Context
+The platform needs a configuration system that:
+- Supports hierarchical configuration (defaults → files → env → secrets)
+- Handles multiple formats (YAML, JSON, env vars)
+- Provides type-safe access to configuration values
+- Supports environment-specific overrides
+- Can integrate with secret managers (future)
+
+Options considered:
+1. **spf13/viper** - Comprehensive configuration management
+2. **envconfig** - Environment variable only
+3. **koanf** - Lightweight configuration library
+4. **Standard library + manual parsing** - No external dependency
+
+## Decision
+Use **spf13/viper** (v1.18.0+) with **spf13/cobra** (v1.8.0+) for configuration management.
+
+**Rationale:**
+- Industry standard for Go configuration management
+- Supports multiple sources (files, env vars, flags)
+- Hierarchical configuration with precedence rules
+- Easy integration with Cobra for CLI commands
+- Well-documented and widely used
+- Supports future secret manager integration
+
+## Consequences
+
+### Positive
+- Flexible configuration loading from multiple sources
+- Easy to add new configuration sources
+- Type-safe access methods
+- Environment variable support via automatic env binding
+
+### Negative
+- Additional dependency
+- Viper can be verbose for simple use cases
+- Some learning curve for advanced features
+
+### Implementation Notes
+- Install: `go get github.com/spf13/viper@v1.18.0` and `github.com/spf13/cobra@v1.8.0`
+- Create `pkg/config/config.go` interface to abstract Viper
+- Implement `internal/config/viper_config.go` as concrete implementation
+- Load order: `default.yaml` → `development.yaml`/`production.yaml` → env vars → secrets (future)
+- Use typed getters (GetString, GetInt, GetBool) for type safety
+
diff --git a/docs/adr/0005-logging-framework.md b/docs/adr/0005-logging-framework.md
new file mode 100644
index 0000000..e8ec3b6
--- /dev/null
+++ b/docs/adr/0005-logging-framework.md
@@ -0,0 +1,50 @@
+# ADR-0005: Logging Framework
+
+## Status
+Accepted
+
+## Context
+The platform requires structured logging that:
+- Supports multiple log levels
+- Provides structured output (JSON for production)
+- Allows adding contextual fields
+- Performs well under load
+- Integrates with observability tools
+
+Options considered:
+1. **go.uber.org/zap** - High-performance structured logging
+2. **rs/zerolog** - Zero-allocation logger
+3. **sirupsen/logrus** - Structured logger (maintenance mode)
+4. **Standard library log** - Basic logging (insufficient)
+
+## Decision
+Use **go.uber.org/zap** (v1.26.0+) as the logging framework.
+
+**Rationale:**
+- Industry standard for high-performance Go applications
+- Excellent structured logging with field support
+- Very low overhead (designed for high-throughput systems)
+- JSON output for production, human-readable for development
+- Strong ecosystem integration
+- Actively maintained by Uber
+
+## Consequences
+
+### Positive
+- High performance (low latency, high throughput)
+- Rich structured logging with fields
+- Easy integration with observability tools
+- Configurable output formats (JSON/console)
+
+### Negative
+- Slightly more verbose API than standard library
+- Requires wrapping for common use cases (we'll abstract via interface)
+
+### Implementation Notes
+- Install: `go get go.uber.org/zap@v1.26.0`
+- Create `pkg/logger/logger.go` interface to abstract zap
+- Implement `internal/logger/zap_logger.go` as concrete implementation
+- Use JSON encoder for production, console encoder for development
+- Support request-scoped fields via context
+- Export global logger via `pkg/logger` package
+
diff --git a/docs/adr/0006-http-framework.md b/docs/adr/0006-http-framework.md
new file mode 100644
index 0000000..0d9cdfe
--- /dev/null
+++ b/docs/adr/0006-http-framework.md
@@ -0,0 +1,50 @@
+# ADR-0006: HTTP Framework
+
+## Status
+Accepted
+
+## Context
+The platform needs an HTTP framework for:
+- REST API endpoints
+- Middleware support (auth, logging, metrics)
+- Request/response handling
+- Route registration from modules
+- Integration with observability tools
+
+Options considered:
+1. **gin-gonic/gin** - Fast, feature-rich HTTP web framework
+2. **gorilla/mux** - Lightweight router
+3. **go-chi/chi** - Lightweight, idiomatic router
+4. **net/http** (standard library) - No external dependency
+
+## Decision
+Use **gin-gonic/gin** (v1.9.1+) as the HTTP framework.
+
+**Rationale:**
+- Fast performance (comparable to net/http)
+- Rich middleware ecosystem
+- Excellent for REST APIs
+- Easy route grouping (useful for modules)
+- Good OpenTelemetry integration support
+- Widely used and well-documented
+- Recommended in playbook-golang.md
+
+## Consequences
+
+### Positive
+- High performance
+- Easy middleware chaining
+- Route grouping supports module architecture
+- Good ecosystem support
+
+### Negative
+- Additional dependency (though lightweight)
+- Slight learning curve for developers unfamiliar with Gin
+
+### Implementation Notes
+- Install: `go get github.com/gin-gonic/gin@v1.9.1`
+- Create router in `internal/server/server.go`
+- Use route groups for module isolation: `r.Group("/api/v1/blog")`
+- Add middleware stack: logging, recovery, metrics, auth (later)
+- Support graceful shutdown via fx lifecycle
+
diff --git a/docs/adr/0007-project-directory-structure.md b/docs/adr/0007-project-directory-structure.md
new file mode 100644
index 0000000..5d12e3e
--- /dev/null
+++ b/docs/adr/0007-project-directory-structure.md
@@ -0,0 +1,82 @@
+# ADR-0007: Project Directory Structure
+
+## Status
+Accepted
+
+## Context
+The project needs a clear, scalable directory structure that:
+- Follows Go best practices
+- Separates public interfaces from implementations
+- Supports modular architecture
+- Is maintainable and discoverable
+- Aligns with Go community standards
+
+## Decision
+Adopt a **standard Go project layout** with **internal/** and **pkg/** separation:
+
+```
+goplt/
+├── cmd/
+│   └── platform/          # Application entry point
+├── internal/              # Private implementation code
+│   ├── di/                # Dependency injection
+│   ├── registry/          # Module registry
+│   ├── pluginloader/      # Plugin loader (optional)
+│   ├── config/            # Config implementation
+│   ├── logger/            # Logger implementation
+│   └── infra/             # Infrastructure adapters
+├── pkg/                   # Public interfaces (exported)
+│   ├── config/            # ConfigProvider interface
+│   ├── logger/            # Logger interface
+│   ├── module/            # IModule interface
+│   ├── auth/              # Auth interfaces (Phase 2)
+│   ├── perm/              # Permission DSL (Phase 2)
+│   └── infra/             # Infrastructure interfaces
+├── modules/               # Feature modules
+│   └── blog/              # Sample module (Phase 4)
+├── config/                # Configuration files
+│   ├── default.yaml
+│   ├── development.yaml
+│   └── production.yaml
+├── api/                   # OpenAPI specs
+├── scripts/               # Build/test scripts
+├── docs/                  # Documentation
+│   └── adr/              # Architecture Decision Records
+├── ops/                   # Operations (Grafana dashboards, etc.)
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── Dockerfile
+├── docker-compose.yml
+├── docker-compose.test.yml
+└── go.mod
+```
+
+**Rationale:**
+- `internal/` prevents external packages from importing implementation details
+- `pkg/` exposes only interfaces that modules need
+- `cmd/` follows Go standard for application entry points
+- `modules/` clearly separates feature modules
+- `config/` centralizes configuration files
+- Separates concerns and supports clean architecture
+
+## Consequences
+
+### Positive
+- Clear separation of concerns
+- Prevents circular dependencies
+- Easy to navigate and understand
+- Aligns with Go community standards
+- Supports modular architecture
+
+### Negative
+- Slightly more directories than minimal structure
+- Requires discipline to maintain boundaries
+
+### Implementation Notes
+- Initialize with `go mod init git.dcentral.systems/toolz/goplt`
+- Create all directories upfront in Phase 0
+- Document structure in `README.md`
+- Enforce boundaries via `internal/` package visibility
+- Use `go build ./...` to verify structure
+
diff --git a/docs/adr/0008-error-handling-strategy.md b/docs/adr/0008-error-handling-strategy.md
new file mode 100644
index 0000000..5f49107
--- /dev/null
+++ b/docs/adr/0008-error-handling-strategy.md
@@ -0,0 +1,57 @@
+# ADR-0008: Error Handling Strategy
+
+## Status
+Accepted
+
+## Context
+Go's error handling philosophy requires explicit error checking. We need a consistent approach for:
+- Error creation and wrapping
+- Error propagation
+- Error classification (domain vs infrastructure)
+- Error reporting (logging, monitoring)
+- HTTP error responses
+
+## Decision
+Adopt a **wrapped error pattern** with **structured error types**:
+
+1. **Error Wrapping**: Use `fmt.Errorf("context: %w", err)` for error wrapping
+2. **Error Types**: Define custom error types for domain errors
+3. **Error Classification**: Distinguish between:
+   - Domain errors (business logic failures)
+   - Infrastructure errors (external system failures)
+   - Validation errors (input validation failures)
+4. **Error Context**: Always wrap errors with context about where they occurred
+
+**Rationale:**
+- Follows Go 1.13+ error wrapping best practices
+- Enables error inspection with `errors.Is()` and `errors.As()`
+- Maintains error chains for debugging
+- Allows structured error handling
+
+## Consequences
+
+### Positive
+- Full error traceability through call stack
+- Can inspect and handle specific error types
+- Better debugging with error context
+- Aligns with Go best practices
+
+### Negative
+- Requires discipline to wrap errors consistently
+- Can be verbose in some cases
+
+### Implementation Notes
+- Always wrap errors: `return nil, fmt.Errorf("failed to load config: %w", err)`
+- Create error types for domain errors:
+  ```go
+  type ConfigError struct {
+      Key   string
+      Cause error
+  }
+  func (e *ConfigError) Error() string { ... }
+  func (e *ConfigError) Unwrap() error { return e.Cause }
+  ```
+- Use `errors.Is()` and `errors.As()` for error checking
+- Log errors with context before returning
+- Map domain errors to HTTP status codes in handlers
+
diff --git a/docs/adr/0009-context-key-types.md b/docs/adr/0009-context-key-types.md
new file mode 100644
index 0000000..da5bd89
--- /dev/null
+++ b/docs/adr/0009-context-key-types.md
@@ -0,0 +1,56 @@
+# ADR-0009: Context Key Types
+
+## Status
+Accepted
+
+## Context
+The platform will use `context.Context` to propagate request-scoped values such as:
+- User ID (from authentication)
+- Request ID (for tracing)
+- Tenant ID (for multi-tenancy)
+- Logger instance (with request-scoped fields)
+
+Go best practices recommend using typed keys instead of string keys to avoid collisions.
+
+## Decision
+Use **typed context keys** for all context values:
+
+```go
+type contextKey string
+
+const (
+    userIDKey contextKey = "user_id"
+    requestIDKey contextKey = "request_id"
+    tenantIDKey contextKey = "tenant_id"
+    loggerKey contextKey = "logger"
+)
+```
+
+**Rationale:**
+- Prevents key collisions between packages
+- Type-safe access to context values
+- Aligns with Go best practices (see `context.WithValue` documentation)
+- Makes context usage explicit and discoverable
+
+## Consequences
+
+### Positive
+- Type-safe context access
+- Prevents accidental key collisions
+- Clear intent in code
+- Better IDE support
+
+### Negative
+- Slightly more verbose than string keys
+- Requires defining keys upfront
+
+### Implementation Notes
+- Create `pkg/context/keys.go` with all context key definitions
+- Provide helper functions for setting/getting values:
+  ```go
+  func WithUserID(ctx context.Context, userID string) context.Context
+  func UserIDFromContext(ctx context.Context) (string, bool)
+  ```
+- Use in middleware and services
+- Document all context keys and their usage
+
diff --git a/docs/adr/0010-ci-cd-platform.md b/docs/adr/0010-ci-cd-platform.md
new file mode 100644
index 0000000..90f7863
--- /dev/null
+++ b/docs/adr/0010-ci-cd-platform.md
@@ -0,0 +1,50 @@
+# ADR-0010: CI/CD Platform
+
+## Status
+Accepted
+
+## Context
+The platform needs a CI/CD system for:
+- Automated testing on pull requests
+- Code quality checks (linting, formatting)
+- Building binaries and Docker images
+- Publishing artifacts
+- Running integration tests
+
+Options considered:
+1. **GitHub Actions** - Native GitHub integration
+2. **GitLab CI** - If using GitLab
+3. **Jenkins** - Self-hosted option
+4. **CircleCI** - Cloud-based CI/CD
+
+## Decision
+Use **GitHub Actions** for CI/CD pipeline.
+
+**Rationale:**
+- Native integration with GitHub repositories
+- Free for public repos, reasonable for private
+- Rich ecosystem of actions
+- Easy to configure with YAML
+- Good documentation and community support
+- Recommended in playbook-golang.md
+
+## Consequences
+
+### Positive
+- Easy setup and configuration
+- Good GitHub integration
+- Large action marketplace
+- Free for public repositories
+
+### Negative
+- Tied to GitHub (if migrating Git hosts, need to migrate CI)
+- Limited customization compared to self-hosted solutions
+
+### Implementation Notes
+- Create `.github/workflows/ci.yml`
+- Use `actions/setup-go@v5` for Go setup
+- Configure caching for Go modules
+- Run: linting, unit tests, integration tests, build
+- Use `actions/cache@v4` for module caching
+- Add build matrix if needed for multiple Go versions (future)
+
diff --git a/docs/adr/0011-code-generation-tools.md b/docs/adr/0011-code-generation-tools.md
new file mode 100644
index 0000000..526c062
--- /dev/null
+++ b/docs/adr/0011-code-generation-tools.md
@@ -0,0 +1,53 @@
+# ADR-0011: Code Generation Tools
+
+## Status
+Accepted
+
+## Context
+The platform will use code generation for:
+- Permission constants from module manifests
+- Ent ORM code generation
+- Mock generation for testing
+- OpenAPI client/server code (future)
+
+We need to decide on tooling and workflow.
+
+## Decision
+Use **standard Go generation tools** with `go generate`:
+
+1. **Ent ORM**: `entgo.io/ent/cmd/ent` for schema code generation
+2. **Mocks**: `github.com/vektra/mockery/v2` or `github.com/golang/mock/mockgen`
+3. **Permissions**: Custom `scripts/generate-permissions.go`
+4. **OpenAPI**: `github.com/deepmap/oapi-codegen` (future)
+
+**Workflow:**
+- Use `//go:generate` directives in source files
+- Run `go generate ./...` before commits
+- Document in `Makefile` with `make generate` target
+- CI should verify generated code is up-to-date
+
+**Rationale:**
+- Standard Go tooling, well-supported
+- `go generate` is the idiomatic way to run code generation
+- Easy to integrate into CI/CD
+- Reduces manual code maintenance
+
+## Consequences
+
+### Positive
+- Automated code generation reduces errors
+- Consistent code style
+- Easy to maintain
+- Standard Go workflow
+
+### Negative
+- Requires developers to run generation before commits
+- Generated code must be committed (or verified in CI)
+- Slight learning curve for new developers
+
+### Implementation Notes
+- Add `//go:generate` directives where needed
+- Create `Makefile` target: `make generate`
+- Add CI step to verify generated code: `go generate ./... && git diff --exit-code`
+- Document in `CONTRIBUTING.md`
+
diff --git a/docs/adr/0012-logger-interface-design.md b/docs/adr/0012-logger-interface-design.md
new file mode 100644
index 0000000..ced6315
--- /dev/null
+++ b/docs/adr/0012-logger-interface-design.md
@@ -0,0 +1,62 @@
+# ADR-0012: Logger Interface Design
+
+## Status
+Accepted
+
+## Context
+We're using zap for logging, but want to abstract it behind an interface for:
+- Testability (mock logger in tests)
+- Flexibility (could swap implementations)
+- Module compatibility (modules use interface, not concrete type)
+
+We need to decide on the interface design.
+
+## Decision
+Create a **simple logger interface** that matches zap's API pattern but uses generic types:
+
+```go
+type Field interface {
+    // Field represents a key-value pair for structured logging
+}
+
+type Logger interface {
+    Debug(msg string, fields ...Field)
+    Info(msg string, fields ...Field)
+    Warn(msg string, fields ...Field)
+    Error(msg string, fields ...Field)
+    With(fields ...Field) Logger
+}
+```
+
+**Implementation:**
+- Use `zap.Field` as the Field type (no abstraction needed for now)
+- Provide helper functions in `pkg/logger` for creating fields:
+  ```go
+  func String(key, value string) Field
+  func Int(key string, value int) Field
+  func Error(err error) Field
+  ```
+
+**Rationale:**
+- Simple interface that modules can depend on
+- Matches zap's usage patterns
+- Easy to test with mock implementations
+- Allows future swap if needed (though unlikely)
+
+## Consequences
+
+### Positive
+- Clean abstraction for modules
+- Testable with mocks
+- Simple API for modules to use
+
+### Negative
+- Slight indirection overhead
+- Need to maintain interface compatibility
+
+### Implementation Notes
+- Define interface in `pkg/logger/logger.go`
+- Implement in `internal/logger/zap_logger.go`
+- Export helper functions in `pkg/logger/fields.go`
+- Modules import `pkg/logger`, not `internal/logger`
+
diff --git a/docs/adr/0013-database-orm.md b/docs/adr/0013-database-orm.md
new file mode 100644
index 0000000..068fecf
--- /dev/null
+++ b/docs/adr/0013-database-orm.md
@@ -0,0 +1,54 @@
+# ADR-0013: Database ORM Selection
+
+## Status
+Accepted
+
+## Context
+The platform needs a database ORM/library that:
+- Supports PostgreSQL (primary database)
+- Provides type-safe query building
+- Supports code generation (reduces boilerplate)
+- Handles migrations
+- Supports relationships (many-to-many, etc.)
+- Integrates with Ent (code generation)
+
+Options considered:
+1. **entgo.io/ent** - Code-generated, type-safe ORM
+2. **gorm.io/gorm** - Feature-rich ORM with reflection
+3. **sqlx** - Lightweight wrapper around database/sql
+4. **Standard library database/sql** - No ORM, raw SQL
+
+## Decision
+Use **entgo.io/ent** as the primary ORM for the platform.
+
+**Rationale:**
+- Code generation provides compile-time type safety
+- Excellent schema definition and migration support
+- Strong relationship modeling
+- Good performance (no reflection at runtime)
+- Active development and good documentation
+- Recommended in playbook-golang.md
+- Easy to integrate with OpenTelemetry
+
+## Consequences
+
+### Positive
+- Type-safe queries eliminate runtime errors
+- Schema changes are explicit and versioned
+- Code generation reduces boilerplate
+- Good migration support
+- Strong relationship support
+
+### Negative
+- Requires code generation step (`go generate`)
+- Learning curve for developers unfamiliar with Ent
+- Less flexible than raw SQL for complex queries
+- Generated code must be committed or verified in CI
+
+### Implementation Notes
+- Install: `go get entgo.io/ent/cmd/ent`
+- Initialize schema: `go run entgo.io/ent/cmd/ent init User Role Permission`
+- Use `//go:generate` directives for code generation
+- Run migrations on startup via `client.Schema.Create()`
+- Create wrapper in `internal/infra/database/client.go` for DI injection
+
diff --git a/docs/adr/0014-health-check-implementation.md b/docs/adr/0014-health-check-implementation.md
new file mode 100644
index 0000000..bce3830
--- /dev/null
+++ b/docs/adr/0014-health-check-implementation.md
@@ -0,0 +1,52 @@
+# ADR-0014: Health Check Implementation
+
+## Status
+Accepted
+
+## Context
+The platform needs health check endpoints for:
+- Kubernetes liveness probes (`/healthz`)
+- Kubernetes readiness probes (`/ready`)
+- Monitoring and alerting
+- Load balancer health checks
+
+Health checks should be:
+- Fast and lightweight
+- Check critical dependencies (database, cache, etc.)
+- Provide clear status indicators
+
+## Decision
+Implement **custom health check registry** with composable checkers:
+
+1. **Liveness endpoint** (`/healthz`): Always returns 200 if process is running
+2. **Readiness endpoint** (`/ready`): Checks all registered health checkers
+3. **Health check interface**: `type HealthChecker interface { Check(ctx context.Context) error }`
+4. **Registry pattern**: Modules can register additional health checkers
+
+**Rationale:**
+- Custom implementation gives full control
+- Composable design allows modules to add checks
+- Simple interface is easy to test
+- No external dependency for basic functionality
+- Can extend with Prometheus metrics later
+
+## Consequences
+
+### Positive
+- Lightweight and fast
+- Extensible by modules
+- Easy to test
+- Clear separation of liveness vs readiness
+
+### Negative
+- Need to implement ourselves (though simple)
+- Must maintain the registry
+
+### Implementation Notes
+- Create `pkg/health/health.go` interface
+- Implement `internal/health/registry.go` with checker map
+- Register core checkers: database, cache (if enabled)
+- Add endpoints to HTTP router
+- Return JSON response: `{"status": "ok", "checks": {...}}`
+- Consider timeout (e.g., 5 seconds) for readiness checks
+
diff --git a/docs/adr/0015-error-bus-implementation.md b/docs/adr/0015-error-bus-implementation.md
new file mode 100644
index 0000000..607b9b9
--- /dev/null
+++ b/docs/adr/0015-error-bus-implementation.md
@@ -0,0 +1,55 @@
+# ADR-0015: Error Bus Implementation
+
+## Status
+Accepted
+
+## Context
+The platform needs a centralized error handling mechanism for:
+- Capturing panics and errors
+- Logging errors consistently
+- Sending errors to external services (Sentry, etc.)
+- Avoiding error handling duplication
+
+Options considered:
+1. **Channel-based in-process bus** - Simple, Go-idiomatic
+2. **Event bus integration** - Use existing event bus
+3. **Direct logging** - No bus, direct integration
+4. **External service integration** - Direct to Sentry
+
+## Decision
+Implement a **channel-based error bus** with pluggable sinks:
+
+1. **Error bus interface**: `type ErrorPublisher interface { Publish(err error) }`
+2. **Channel-based implementation**: Background goroutine consumes errors from channel
+3. **Pluggable sinks**: Logger (always), Sentry (optional, Phase 6)
+4. **Panic recovery middleware**: Automatically publishes panics to error bus
+
+**Rationale:**
+- Simple, idiomatic Go pattern
+- Non-blocking error publishing (buffered channel)
+- Decouples error capture from error handling
+- Easy to add new sinks (Sentry, logging, metrics)
+- Can be extended to use event bus later if needed
+
+## Consequences
+
+### Positive
+- Centralized error handling
+- Non-blocking (doesn't slow down request path)
+- Easy to extend with new sinks
+- Consistent error handling across the platform
+
+### Negative
+- Additional goroutine overhead (minimal)
+- Must ensure error bus doesn't become bottleneck
+
+### Implementation Notes
+- Create `pkg/errorbus/errorbus.go` interface
+- Implement `internal/errorbus/channel_bus.go`:
+  - Buffered channel (e.g., size 100)
+  - Background goroutine consumes errors
+  - Multiple sinks (logger, optional Sentry)
+- Add panic recovery middleware that publishes to bus
+- Register in DI container as singleton
+- Monitor channel size to detect error storms
+
diff --git a/docs/adr/0016-opentelemetry-observability.md b/docs/adr/0016-opentelemetry-observability.md
new file mode 100644
index 0000000..19244db
--- /dev/null
+++ b/docs/adr/0016-opentelemetry-observability.md
@@ -0,0 +1,56 @@
+# ADR-0016: OpenTelemetry Observability Strategy
+
+## Status
+Accepted
+
+## Context
+The platform needs distributed tracing and observability for:
+- Request tracing across services/modules
+- Performance monitoring
+- Debugging production issues
+- Integration with observability tools (Jaeger, Grafana, etc.)
+
+Options considered:
+1. **OpenTelemetry** - Industry standard, vendor-neutral
+2. **Zipkin** - Older standard, less ecosystem support
+3. **Custom tracing** - Build our own
+4. **No tracing** - Only logs and metrics
+
+## Decision
+Use **OpenTelemetry (OTEL)** for all observability:
+
+1. **Tracing**: Distributed tracing with spans
+2. **Metrics**: Prometheus-compatible metrics
+3. **Logs**: Structured logs with trace correlation
+4. **Export**: OTLP collector for production, stdout for development
+
+**Rationale:**
+- Industry standard, vendor-neutral
+- Excellent Go SDK support
+- Integrates with major observability tools
+- Supports metrics, traces, and logs
+- Recommended in playbook-golang.md
+- Future-proof (not locked to specific vendor)
+
+## Consequences
+
+### Positive
+- Vendor-neutral (can switch backends)
+- Rich ecosystem and tooling
+- Excellent Go SDK
+- Supports all observability signals
+
+### Negative
+- Learning curve for OpenTelemetry concepts
+- Slight overhead (minimal with sampling)
+- Requires OTLP collector or compatible backend
+
+### Implementation Notes
+- Install: `go.opentelemetry.io/otel` and contrib packages
+- Initialize TracerProvider in `internal/observability/tracer.go`
+- Use HTTP instrumentation middleware: `otelhttp.NewHandler()`
+- Add database instrumentation via Ent interceptor
+- Export to stdout for development, OTLP for production
+- Include trace ID in structured logs
+- Configure sampling for production (e.g., 10% or adaptive)
+
diff --git a/docs/adr/0017-jwt-token-strategy.md b/docs/adr/0017-jwt-token-strategy.md
new file mode 100644
index 0000000..bdd3b32
--- /dev/null
+++ b/docs/adr/0017-jwt-token-strategy.md
@@ -0,0 +1,55 @@
+# ADR-0017: JWT Token Strategy
+
+## Status
+Accepted
+
+## Context
+The platform needs authentication tokens that:
+- Are stateless (no server-side session storage)
+- Support role and permission claims
+- Can be revoked (challenge)
+- Have appropriate lifetimes
+- Support multi-tenancy (tenant ID in claims)
+
+Token strategies considered:
+1. **Short-lived access tokens + long-lived refresh tokens** - Industry standard
+2. **Single long-lived tokens** - Simple but insecure
+3. **Short-lived tokens only** - Secure but poor UX
+4. **Session-based** - Stateful, requires storage
+
+## Decision
+Use **short-lived access tokens + long-lived refresh tokens**:
+
+1. **Access tokens**: 15 minutes lifetime, contain user ID, roles, tenant ID
+2. **Refresh tokens**: 7 days lifetime, stored in database (for revocation)
+3. **Token format**: JWT with claims: `sub` (user ID), `roles`, `tenant_id`, `exp`
+4. **Revocation**: Refresh tokens stored in DB, can be revoked/deleted
+
+**Rationale:**
+- Industry best practice (OAuth2/OIDC pattern)
+- Good balance of security and UX
+- Access tokens can't be revoked (short lifetime mitigates risk)
+- Refresh tokens can be revoked (stored in DB)
+- Supports stateless authentication for most requests
+
+## Consequences
+
+### Positive
+- Secure (short access token lifetime)
+- Good UX (refresh tokens prevent frequent re-login)
+- Stateless for most requests (access tokens)
+- Supports revocation (refresh tokens)
+
+### Negative
+- Requires refresh token storage (DB table)
+- More complex than single token
+- Need to handle token refresh flow
+
+### Implementation Notes
+- Use `github.com/golang-jwt/jwt/v5` for JWT handling
+- Store refresh tokens in `refresh_tokens` table (user_id, token_hash, expires_at)
+- Generate access tokens with HS256 or RS256 signing
+- Include roles in token claims (not just role IDs)
+- Validate token signature and expiration on each request
+- Refresh endpoint validates refresh token and issues new access token
+
diff --git a/docs/adr/0018-password-hashing.md b/docs/adr/0018-password-hashing.md
new file mode 100644
index 0000000..35b9b54
--- /dev/null
+++ b/docs/adr/0018-password-hashing.md
@@ -0,0 +1,53 @@
+# ADR-0018: Password Hashing Algorithm
+
+## Status
+Accepted
+
+## Context
+The platform needs to securely store user passwords. Requirements:
+- Resist brute-force attacks
+- Resist rainbow table attacks
+- Future-proof against advances in computing
+- Reasonable performance (not too slow)
+
+Options considered:
+1. **bcrypt** - Battle-tested, widely used
+2. **argon2id** - Modern, memory-hard, recommended by OWASP
+3. **scrypt** - Memory-hard, good alternative
+4. **PBKDF2** - Older standard, less secure
+
+## Decision
+Use **argon2id** for password hashing with recommended parameters:
+
+- **Algorithm**: argon2id (variant)
+- **Memory**: 64 MB (65536 KB)
+- **Iterations**: 3 (time cost)
+- **Parallelism**: 4 (number of threads)
+- **Salt length**: 16 bytes (random, unique per password)
+
+**Rationale:**
+- Recommended by OWASP for new applications
+- Memory-hard algorithm (resistant to GPU/ASIC attacks)
+- Good balance of security and performance
+- Future-proof design
+- Standard library support in Go 1.23+
+
+## Consequences
+
+### Positive
+- Strong security guarantees
+- Memory-hard (resistant to hardware attacks)
+- OWASP recommended
+- Standard library support
+
+### Negative
+- Slightly slower than bcrypt (acceptable trade-off)
+- Requires tuning parameters for production
+
+### Implementation Notes
+- Use `golang.org/x/crypto/argon2` package
+- Store hash in format: `$argon2id$v=19$m=65536,t=3,p=4$salt$hash`
+- Use `crypto/rand` for salt generation
+- Verify passwords with `argon2.CompareHashAndPassword()`
+- Consider increasing parameters for high-security environments
+
diff --git a/docs/adr/0019-permission-dsl-format.md b/docs/adr/0019-permission-dsl-format.md
new file mode 100644
index 0000000..545cd81
--- /dev/null
+++ b/docs/adr/0019-permission-dsl-format.md
@@ -0,0 +1,57 @@
+# ADR-0019: Permission DSL Format
+
+## Status
+Accepted
+
+## Context
+The platform needs a permission system that:
+- Is extensible by modules
+- Prevents typos and errors (compile-time safety)
+- Supports hierarchical permissions
+- Is easy to understand and use
+
+Permission formats considered:
+1. **String format**: `"module.resource.action"` - Simple, flexible
+2. **Enum/Constants**: Type-safe but less flexible
+3. **Hierarchical tree**: Complex but powerful
+4. **Bitmask**: Efficient but hard to read
+
+## Decision
+Use **string-based permission format** with **code-generated constants**:
+
+1. **Format**: `"{module}.{resource}.{action}"`
+   - Examples: `blog.post.create`, `user.read`, `system.health.check`
+2. **Code generation**: Generate constants from `module.yaml` files
+3. **Type safety**: `type Permission string` with generated constants
+4. **Validation**: Compile-time constants prevent typos
+
+**Rationale:**
+- Simple and readable
+- Easy to extend (modules define in manifest)
+- Code generation provides compile-time safety
+- Flexible (modules can define any format)
+- Hierarchical structure is intuitive
+- Easy to parse and match
+
+## Consequences
+
+### Positive
+- Simple and intuitive format
+- Compile-time safety via code generation
+- Easy to extend by modules
+- Human-readable
+- Flexible for various permission models
+
+### Negative
+- String comparisons (minimal performance impact)
+- Requires code generation step
+- Potential for permission string conflicts (mitigated by module prefix)
+
+### Implementation Notes
+- Define `type Permission string` in `pkg/perm/perm.go`
+- Create code generator: `scripts/generate-permissions.go`
+- Scan `modules/*/module.yaml` for permissions
+- Generate constants in `pkg/perm/generated.go`
+- Use `//go:generate` directive
+- Validate format: `^[a-z0-9]+(\.[a-z0-9]+)*$` (lowercase, dots)
+
diff --git a/docs/adr/0020-audit-logging-storage.md b/docs/adr/0020-audit-logging-storage.md
new file mode 100644
index 0000000..f95a4a7
--- /dev/null
+++ b/docs/adr/0020-audit-logging-storage.md
@@ -0,0 +1,63 @@
+# ADR-0020: Audit Logging Storage
+
+## Status
+Accepted
+
+## Context
+The platform needs to audit all security-relevant actions:
+- User logins and authentication attempts
+- Permission changes
+- Data modifications
+- Administrative actions
+
+Audit logs must be:
+- Immutable (append-only)
+- Queryable
+- Performant (don't slow down operations)
+- Compliant with audit requirements
+
+Storage options considered:
+1. **PostgreSQL table** - Simple, queryable, transactional
+2. **Elasticsearch** - Excellent for searching, but additional dependency
+3. **File-based logs** - Simple but hard to query
+4. **External audit service** - Overkill for initial version
+
+## Decision
+Store audit logs in **PostgreSQL append-only table** with JSON metadata:
+
+1. **Table structure**: `audit_logs` with columns:
+   - `id`, `actor_id`, `action`, `target_id`, `metadata` (JSONB), `timestamp`
+2. **Append-only**: No UPDATE or DELETE operations
+3. **JSON metadata**: Flexible storage for additional context
+4. **Indexing**: Index on `actor_id`, `action`, `timestamp` for queries
+
+**Rationale:**
+- Simple (no additional infrastructure)
+- Queryable via SQL
+- Transactional (consistent with other data)
+- JSONB provides flexibility for metadata
+- Can migrate to Elasticsearch later if needed
+- Good performance for typical audit volumes
+
+## Consequences
+
+### Positive
+- Simple implementation
+- Queryable via SQL
+- No additional infrastructure
+- Transactional consistency
+- Can archive old logs if needed
+
+### Negative
+- Adds load to primary database
+- May need archiving strategy for large volumes
+- Less powerful search than Elasticsearch
+
+### Implementation Notes
+- Create `audit_logs` table via Ent schema
+- Use JSONB for metadata column (PostgreSQL-specific)
+- Add indexes: `(actor_id, timestamp)`, `(action, timestamp)`
+- Implement async logging (optional, via channel) for high throughput
+- Consider partitioning by date for large volumes
+- Add retention policy (e.g., archive after 1 year)
+
diff --git a/docs/adr/0021-module-loading-strategy.md b/docs/adr/0021-module-loading-strategy.md
new file mode 100644
index 0000000..39e95e1
--- /dev/null
+++ b/docs/adr/0021-module-loading-strategy.md
@@ -0,0 +1,54 @@
+# ADR-0021: Module Loading Strategy
+
+## Status
+Accepted
+
+## Context
+The platform needs to support pluggable modules. Two approaches:
+1. **Static registration** - Modules compiled into binary
+2. **Dynamic plugin loading** - Load `.so` files at runtime
+
+Each has trade-offs for development, CI, and production.
+
+## Decision
+Support **both approaches** with **static registration as primary**:
+
+1. **Static registration (primary)**:
+   - Modules register via `init()` function
+   - Imported via `import _ "module/pkg"` in main
+   - Works everywhere (Windows, Linux, macOS)
+   - Compile-time type safety
+
+2. **Dynamic plugin loading (optional)**:
+   - Support via Go `plugin` package
+   - Load `.so` files from `./plugins/` directory
+   - Only for production scenarios requiring hot-swap
+   - Linux/macOS only (Go plugin limitation)
+
+**Rationale:**
+- Static registration is simpler and more reliable
+- Works in CI/CD (no plugin compilation needed)
+- Compile-time safety catches errors early
+- Dynamic loading provides flexibility for specific use cases
+- Modules can choose their approach
+
+## Consequences
+
+### Positive
+- Flexible: static for most cases, dynamic when needed
+- Static registration works everywhere
+- Compile-time safety with static
+- Hot-swap capability with dynamic (Linux/macOS)
+
+### Negative
+- Two code paths to maintain
+- Dynamic plugins have version compatibility constraints
+- Plugin debugging is harder
+
+### Implementation Notes
+- Implement static registry in `internal/registry/registry.go`
+- Modules register via: `registry.Register(Module)` in `init()`
+- Implement plugin loader in `internal/pluginloader/plugin_loader.go` (optional)
+- Document when to use each approach
+- Validate plugin version compatibility if using dynamic loading
+
diff --git a/docs/adr/0022-cache-implementation.md b/docs/adr/0022-cache-implementation.md
new file mode 100644
index 0000000..3b7613d
--- /dev/null
+++ b/docs/adr/0022-cache-implementation.md
@@ -0,0 +1,56 @@
+# ADR-0022: Cache Implementation
+
+## Status
+Accepted
+
+## Context
+The platform needs caching for:
+- Performance optimization (reduce database load)
+- Frequently accessed data (user permissions, roles)
+- Session data (optional)
+- Query results
+
+Options considered:
+1. **Redis** - Industry standard, feature-rich
+2. **In-memory cache** - Simple, no external dependency
+3. **Memcached** - Simple, but less features than Redis
+4. **No cache** - Simplest, but poor performance at scale
+
+## Decision
+Use **Redis** as the primary cache with **in-memory fallback**:
+
+1. **Primary**: Redis for production
+2. **Fallback**: In-memory cache for development/testing
+3. **Interface abstraction**: `Cache` interface allows swapping implementations
+4. **Use cases**: Permission lookups, role assignments, query caching
+
+**Rationale:**
+- Industry standard, widely supported
+- Rich feature set (TTL, pub/sub, etc.)
+- Can be shared across instances (multi-instance deployments)
+- Good performance
+- Easy to abstract behind interface
+
+## Consequences
+
+### Positive
+- High performance
+- Shared across instances
+- Rich feature set
+- Easy to scale horizontally
+- Abstraction allows swapping implementations
+
+### Negative
+- Additional infrastructure dependency
+- Network latency (minimal with proper setup)
+- Need to handle Redis failures gracefully
+
+### Implementation Notes
+- Install: `github.com/redis/go-redis/v9`
+- Create `pkg/infra/cache/cache.go` interface
+- Implement `internal/infra/cache/redis_cache.go`
+- Implement `internal/infra/cache/memory_cache.go` for fallback
+- Use connection pooling
+- Handle Redis failures gracefully (fallback or error)
+- Configure TTLs appropriately (e.g., 5 minutes for permissions)
+
diff --git a/docs/adr/0023-event-bus-implementation.md b/docs/adr/0023-event-bus-implementation.md
new file mode 100644
index 0000000..a8fd96c
--- /dev/null
+++ b/docs/adr/0023-event-bus-implementation.md
@@ -0,0 +1,59 @@
+# ADR-0023: Event Bus Implementation
+
+## Status
+Accepted
+
+## Context
+The platform needs an event bus for:
+- Module-to-module communication
+- Decoupled event publishing
+- Event sourcing (optional, future)
+- Integration with external systems
+
+Options considered:
+1. **In-process channel-based bus** - Simple, for development/testing
+2. **Kafka** - Production-grade, scalable
+3. **RabbitMQ** - Alternative message broker
+4. **Redis pub/sub** - Simple but less reliable
+
+## Decision
+Support **dual implementation** with **in-process primary, Kafka for production**:
+
+1. **In-process bus (default)**:
+   - Channel-based implementation
+   - Used for development, testing, small deployments
+   - Simple, no external dependencies
+
+2. **Kafka bus (production)**:
+   - Full Kafka integration via `segmentio/kafka-go`
+   - Producer/consumer groups
+   - Configurable via environment (switch implementation)
+
+**Rationale:**
+- In-process bus is simple for development
+- Kafka provides production-grade reliability and scalability
+- Interface abstraction allows swapping
+- Modules don't need to know which implementation
+- Can start simple and scale up
+
+## Consequences
+
+### Positive
+- Simple for development (no Kafka needed)
+- Scalable for production (Kafka)
+- Flexible (can choose implementation)
+- Modules are decoupled from implementation
+
+### Negative
+- Two implementations to maintain
+- Need to ensure interface covers both use cases
+- Kafka adds infrastructure complexity
+
+### Implementation Notes
+- Create `pkg/eventbus/eventbus.go` interface
+- Implement `internal/infra/bus/inprocess_bus.go` (channel-based)
+- Implement `internal/infra/bus/kafka_bus.go` (Kafka)
+- Select implementation via config
+- Support both sync and async event publishing
+- Handle errors gracefully (retry, dead letter queue)
+
diff --git a/docs/adr/0024-job-scheduler.md b/docs/adr/0024-job-scheduler.md
new file mode 100644
index 0000000..9b80a07
--- /dev/null
+++ b/docs/adr/0024-job-scheduler.md
@@ -0,0 +1,56 @@
+# ADR-0024: Background Job Scheduler
+
+## Status
+Accepted
+
+## Context
+The platform needs background job processing for:
+- Periodic tasks (cron jobs)
+- Asynchronous processing
+- Long-running operations
+- Retry logic for failed jobs
+
+Options considered:
+1. **asynq (Redis-based)** - Simple, feature-rich
+2. **cron + custom queue** - Build our own
+3. **Kafka consumers** - Use event bus
+4. **External service** - AWS SQS, etc.
+
+## Decision
+Use **asynq** (Redis-backed) for job scheduling:
+
+1. **Cron jobs**: `github.com/robfig/cron/v3` for periodic tasks
+2. **Job queue**: `github.com/hibiken/asynq` for async jobs
+3. **Storage**: Redis (shared with cache)
+4. **Features**: Retries, backoff, job status tracking
+
+**Rationale:**
+- Simple, Redis-backed (no new infrastructure)
+- Good Go library support
+- Built-in retry and backoff
+- Job status tracking
+- Easy to integrate
+- Can scale horizontally (multiple workers)
+
+## Consequences
+
+### Positive
+- Simple (uses existing Redis)
+- Feature-rich (retries, backoff)
+- Good performance
+- Easy to scale
+- Job status tracking
+
+### Negative
+- Tied to Redis (but we're already using it)
+- Requires Redis to be available
+
+### Implementation Notes
+- Install: `github.com/hibiken/asynq` and `github.com/robfig/cron/v3`
+- Create `pkg/scheduler/scheduler.go` interface
+- Implement `internal/infra/scheduler/asynq_scheduler.go`
+- Register jobs in `internal/infra/scheduler/job_registry.go`
+- Start worker in fx lifecycle
+- Configure retry policies (exponential backoff)
+- Add job monitoring endpoint
+
diff --git a/docs/adr/0025-multitenancy-model.md b/docs/adr/0025-multitenancy-model.md
new file mode 100644
index 0000000..b397824
--- /dev/null
+++ b/docs/adr/0025-multitenancy-model.md
@@ -0,0 +1,49 @@
+# ADR-0025: Multi-tenancy Model
+
+## Status
+Accepted
+
+## Context
+The platform may need multi-tenancy support for SaaS deployments. Options:
+1. **Shared database with tenant_id column** - Single DB, row-level isolation
+2. **Schema-per-tenant** - Single DB, separate schemas
+3. **Database-per-tenant** - Separate databases
+
+Each has trade-offs for isolation, performance, and operational complexity.
+
+## Decision
+Use **shared database with tenant_id column** (optional feature):
+
+1. **Model**: Single PostgreSQL database with `tenant_id` column on tenant-scoped tables
+2. **Isolation**: Row-level via Ent interceptors (automatic filtering)
+3. **Tenant resolution**: From header (`X-Tenant-ID`), subdomain, or JWT claim
+4. **Optional**: Can be disabled for single-tenant deployments
+
+**Rationale:**
+- Simplest operational model (single database)
+- Good performance (can index tenant_id)
+- Easy to implement (Ent interceptors)
+- Can migrate to schema-per-tenant later if needed
+- Flexible (can support both single and multi-tenant)
+
+## Consequences
+
+### Positive
+- Simple operations (single database)
+- Good performance with proper indexing
+- Easy to implement
+- Flexible (optional feature)
+
+### Negative
+- Requires careful query design (ensure tenant_id filtering)
+- Data isolation at application level (not database level)
+- Potential for data leakage if bugs occur
+
+### Implementation Notes
+- Make tenant_id optional (nullable) for single-tenant mode
+- Add Ent interceptor to automatically filter by tenant_id
+- Resolve tenant from context via middleware
+- Add tenant_id to JWT claims
+- Document tenant isolation guarantees
+- Consider adding tenant_id to all tenant-scoped tables
+
diff --git a/docs/adr/0026-error-reporting-service.md b/docs/adr/0026-error-reporting-service.md
new file mode 100644
index 0000000..e5752a0
--- /dev/null
+++ b/docs/adr/0026-error-reporting-service.md
@@ -0,0 +1,54 @@
+# ADR-0026: Error Reporting Service
+
+## Status
+Accepted
+
+## Context
+The platform needs error reporting for:
+- Production error tracking
+- Stack trace collection
+- Error aggregation and analysis
+- Integration with monitoring
+
+Options considered:
+1. **Sentry** - Popular, feature-rich
+2. **Rollbar** - Alternative error tracking
+3. **Custom solution** - Build our own
+4. **Logs only** - No external service
+
+## Decision
+Use **Sentry** for error reporting (optional, configurable):
+
+1. **Integration**: Via error bus sink
+2. **Configuration**: Sentry DSN from config
+3. **Context**: Include user ID, trace ID, module name
+4. **Optional**: Can be disabled for development
+
+**Rationale:**
+- Industry standard error tracking
+- Excellent Go SDK
+- Rich features (release tracking, grouping, etc.)
+- Good free tier
+- Easy to integrate
+
+## Consequences
+
+### Positive
+- Excellent error tracking
+- Rich context and grouping
+- Easy integration
+- Good free tier
+
+### Negative
+- External dependency
+- Additional cost at scale
+- Privacy considerations (data sent to Sentry)
+
+### Implementation Notes
+- Install: `github.com/getsentry/sentry-go`
+- Create Sentry sink for error bus
+- Configure via environment variable
+- Include context: user ID, trace ID, module name
+- Set up release tracking
+- Configure sampling for high-volume deployments
+
diff --git a/docs/adr/0027-rate-limiting-strategy.md b/docs/adr/0027-rate-limiting-strategy.md
new file mode 100644
index 0000000..8d53120
--- /dev/null
+++ b/docs/adr/0027-rate-limiting-strategy.md
@@ -0,0 +1,54 @@
+# ADR-0027: Rate Limiting Strategy
+
+## Status
+Accepted
+
+## Context
+The platform needs rate limiting to:
+- Prevent abuse and DoS attacks
+- Protect against brute-force attacks
+- Ensure fair resource usage
+- Comply with API usage policies
+
+Rate limiting strategies:
+1. **Per-user rate limiting** - Based on authenticated user
+2. **Per-IP rate limiting** - Based on client IP
+3. **Fixed rate limiting** - Global limits
+4. **Distributed rate limiting** - Shared state across instances
+
+## Decision
+Implement **multi-level rate limiting**:
+
+1. **Per-user rate limiting**: For authenticated requests (e.g., 100 req/min)
+2. **Per-IP rate limiting**: For all requests (e.g., 1000 req/min)
+3. **Storage**: Redis for distributed rate limiting
+4. **Algorithm**: Token bucket or sliding window
+
+**Rationale:**
+- Multi-level provides defense in depth
+- Per-user prevents abuse by authenticated users
+- Per-IP protects against unauthenticated abuse
+- Redis enables distributed rate limiting (multi-instance)
+- Token bucket provides smooth rate limiting
+
+## Consequences
+
+### Positive
+- Multi-layer protection
+- Works with multiple instances
+- Configurable per endpoint
+- Standard approach
+
+### Negative
+- Requires Redis (or shared state)
+- Additional latency (minimal)
+- Need to handle Redis failures gracefully
+
+### Implementation Notes
+- Use `github.com/ulule/limiter/v3` library
+- Configure limits in config file
+- Store rate limit state in Redis
+- Return `X-RateLimit-*` headers
+- Handle Redis failures gracefully (fail open or closed based on config)
+- Configure different limits for different endpoints
+
diff --git a/docs/adr/0028-testing-strategy.md b/docs/adr/0028-testing-strategy.md
new file mode 100644
index 0000000..e146be0
--- /dev/null
+++ b/docs/adr/0028-testing-strategy.md
@@ -0,0 +1,67 @@
+# ADR-0028: Testing Strategy
+
+## Status
+Accepted
+
+## Context
+The platform needs a comprehensive testing strategy:
+- Unit tests for individual components
+- Integration tests for full flows
+- Contract tests for API compatibility
+- Load tests for performance
+
+Testing tools and approaches vary in complexity and coverage.
+
+## Decision
+Adopt a **multi-layered testing approach**:
+
+1. **Unit tests**:
+   - Tool: Standard `testing` package + `testify`
+   - Coverage: >80% for core modules
+   - Mocks: `mockery` or `mockgen`
+   - Fast execution (< 1 second)
+
+2. **Integration tests**:
+   - Tool: `testcontainers-go` for Docker-based services
+   - Coverage: End-to-end flows (auth, modules, etc.)
+   - Infrastructure: PostgreSQL, Redis, Kafka via testcontainers
+   - Tagged: `//go:build integration`
+
+3. **Contract tests**:
+   - Tool: OpenAPI validator (`kin-openapi`)
+   - Coverage: API request/response validation
+   - Optional: Pact for service contracts
+
+4. **Load tests**:
+   - Tool: k6 or vegeta
+   - Coverage: Critical endpoints (auth, API)
+   - Performance benchmarks
+
+**Rationale:**
+- Comprehensive coverage across layers
+- Fast feedback with unit tests
+- Realistic testing with integration tests
+- API compatibility with contract tests
+- Performance validation with load tests
+
+## Consequences
+
+### Positive
+- High confidence in code quality
+- Fast unit tests for quick feedback
+- Realistic integration tests
+- API compatibility guaranteed
+
+### Negative
+- Integration tests are slower
+- Requires Docker for testcontainers
+- More complex CI setup
+
+### Implementation Notes
+- Use `testify` for assertions: `require` and `assert`
+- Generate mocks with `mockery` or `mockgen`
+- Create test helpers in `internal/testutil/`
+- Use test tags: `go test -tags=integration ./...`
+- Run integration tests in separate CI job
+- Document testing approach in `CONTRIBUTING.md`
+
diff --git a/docs/adr/README.md b/docs/adr/README.md
new file mode 100644
index 0000000..18fa212
--- /dev/null
+++ b/docs/adr/README.md
@@ -0,0 +1,86 @@
+# Architecture Decision Records (ADRs)
+
+This directory contains Architecture Decision Records (ADRs) for the Go Platform project.
+
+## What are ADRs?
+
+ADRs document important architectural decisions made during the project. They help:
+- Track why decisions were made
+- Understand the context and constraints
+- Review decisions when requirements change
+- Onboard new team members
+
+## ADR Format
+
+Each ADR follows this structure:
+- **Status**: Proposed | Accepted | Rejected | Superseded
+- **Context**: The situation that led to the decision
+- **Decision**: What was decided
+- **Consequences**: Positive and negative impacts
+
+## ADR Index
+
+### Phase 0: Project Setup & Foundation
+
+- [ADR-0001: Go Module Path](./0001-go-module-path.md) - Module path: `git.dcentral.systems/toolz/goplt`
+- [ADR-0002: Go Version](./0002-go-version.md) - Go 1.24.3
+- [ADR-0003: Dependency Injection Framework](./0003-dependency-injection-framework.md) - uber-go/fx
+- [ADR-0004: Configuration Management](./0004-configuration-management.md) - spf13/viper + cobra
+- [ADR-0005: Logging Framework](./0005-logging-framework.md) - go.uber.org/zap
+- [ADR-0006: HTTP Framework](./0006-http-framework.md) - gin-gonic/gin
+- [ADR-0007: Project Directory Structure](./0007-project-directory-structure.md) - Standard Go layout with internal/pkg separation
+- [ADR-0008: Error Handling Strategy](./0008-error-handling-strategy.md) - Wrapped errors with typed errors
+- [ADR-0009: Context Key Types](./0009-context-key-types.md) - Typed context keys
+- [ADR-0010: CI/CD Platform](./0010-ci-cd-platform.md) - GitHub Actions
+- [ADR-0011: Code Generation Tools](./0011-code-generation-tools.md) - go generate workflow
+- [ADR-0012: Logger Interface Design](./0012-logger-interface-design.md) - Logger interface abstraction
+
+### Phase 1: Core Kernel & Infrastructure
+
+- [ADR-0013: Database ORM Selection](./0013-database-orm.md) - entgo.io/ent
+- [ADR-0014: Health Check Implementation](./0014-health-check-implementation.md) - Custom health check registry
+- [ADR-0015: Error Bus Implementation](./0015-error-bus-implementation.md) - Channel-based error bus with pluggable sinks
+- [ADR-0016: OpenTelemetry Observability Strategy](./0016-opentelemetry-observability.md) - OpenTelemetry for tracing, metrics, logs
+
+### Phase 2: Authentication & Authorization
+
+- [ADR-0017: JWT Token Strategy](./0017-jwt-token-strategy.md) - Short-lived access tokens + long-lived refresh tokens
+- [ADR-0018: Password Hashing Algorithm](./0018-password-hashing.md) - argon2id
+- [ADR-0019: Permission DSL Format](./0019-permission-dsl-format.md) - String-based format with code generation
+- [ADR-0020: Audit Logging Storage](./0020-audit-logging-storage.md) - PostgreSQL append-only table with JSONB metadata
+
+### Phase 3: Module Framework
+
+- [ADR-0021: Module Loading Strategy](./0021-module-loading-strategy.md) - Static registration (primary) + dynamic plugin loading (optional)
+
+### Phase 5: Infrastructure Adapters
+
+- [ADR-0022: Cache Implementation](./0022-cache-implementation.md) - Redis with in-memory fallback
+- [ADR-0023: Event Bus Implementation](./0023-event-bus-implementation.md) - In-process bus (default) + Kafka (production)
+- [ADR-0024: Background Job Scheduler](./0024-job-scheduler.md) - asynq (Redis-backed) + cron
+- [ADR-0025: Multi-tenancy Model](./0025-multitenancy-model.md) - Shared database with tenant_id column (optional)
+
+### Phase 6: Observability & Production Readiness
+
+- [ADR-0026: Error Reporting Service](./0026-error-reporting-service.md) - Sentry (optional, configurable)
+- [ADR-0027: Rate Limiting Strategy](./0027-rate-limiting-strategy.md) - Multi-level (per-user + per-IP) with Redis
+
+### Phase 7: Testing, Documentation & CI/CD
+
+- [ADR-0028: Testing Strategy](./0028-testing-strategy.md) - Multi-layered (unit, integration, contract, load)
+
+## Adding New ADRs
+
+When making a new architectural decision:
+
+1. Create a new file: `XXXX-short-title.md` (next sequential number)
+2. Follow the ADR template
+3. Update this README with the new entry
+4. Set status to "Proposed" initially
+5. Update to "Accepted" after review/approval
+
+## References
+
+- [ADR Template](https://adr.github.io/madr/)
+- [Documenting Architecture Decisions](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions)
+
diff --git a/docs/plan.md b/docs/plan.md
new file mode 100644
index 0000000..7e6b7b1
--- /dev/null
+++ b/docs/plan.md
@@ -0,0 +1,1485 @@
+# Go Platform Implementation Plan
+
+**"Plug‑in‑friendly SaaS/Enterprise Platform – Go Edition"**
+
+> This document outlines a complete, phased implementation plan for building the Go platform boilerplate based on the requirements from `playbook.md` and `playbook-golang.md`.
+
+---
+
+## Executive Summary
+
+This plan breaks down the implementation into **8 phases**, each with specific deliverables and acceptance criteria. The approach prioritizes building a solid foundation (core kernel) before adding feature modules and advanced capabilities.
+
+**Total Estimated Timeline:** 8-12 weeks (depending on team size and parallelization)
+
+**Key Principles:**
+- **Clean/Hexagonal Architecture** with clear separation between `pkg/` (interfaces) and `internal/` (implementations)
+- **Dependency Injection** using `uber-go/fx` for lifecycle management
+- **Modular Monolith** design that can evolve into microservices
+- **Plugin-first** architecture supporting both static and dynamic module loading
+- **Security-by-Design** with JWT auth, RBAC/ABAC, and audit logging
+- **Observability** via OpenTelemetry, Prometheus, and structured logging
+
+---
+
+## Phase 0: Project Setup & Foundation (Week 1)
+
+### Objectives
+- Initialize repository structure
+- Set up Go modules and basic tooling
+- Create configuration management foundation
+- Establish CI/CD skeleton
+
+### Tasks
+
+#### 0.1 Repository Bootstrap
+- [ ] Initialize Go module: `go mod init github.com/yourorg/platform`
+- [ ] Create directory structure:
+  ```
+  platform/
+  ├── cmd/
+  │   └── platform/          # Main entry point
+  ├── internal/              # Private implementation code
+  │   ├── di/                # Dependency injection container
+  │   ├── registry/          # Module registry
+  │   ├── pluginloader/      # Plugin loader (optional)
+  │   └── infra/             # Infrastructure adapters
+  ├── pkg/                   # Public interfaces (exported)
+  │   ├── config/            # ConfigProvider interface
+  │   ├── logger/            # Logger interface
+  │   ├── module/            # IModule interface
+  │   ├── auth/              # Auth interfaces
+  │   ├── perm/              # Permission DSL
+  │   └── infra/             # Infrastructure interfaces
+  ├── modules/               # Feature modules
+  │   └── blog/              # Sample Blog module (Phase 4)
+  ├── config/                # Configuration files
+  │   ├── default.yaml
+  │   ├── development.yaml
+  │   └── production.yaml
+  ├── api/                   # OpenAPI specs
+  ├── scripts/               # Build/test scripts
+  ├── docs/                  # Documentation
+  ├── ops/                   # Operations (Grafana dashboards, etc.)
+  ├── .github/
+  │   └── workflows/
+  │       └── ci.yml
+  ├── Dockerfile
+  ├── docker-compose.yml
+  ├── docker-compose.test.yml
+  └── go.mod
+  ```
+- [ ] Add `.gitignore` for Go projects
+- [ ] Create initial `README.md` with project overview
+
+#### 0.2 Configuration System
+- [ ] Install `github.com/spf13/viper` and `github.com/spf13/cobra`
+- [ ] Create `pkg/config/config.go` interface:
+  ```go
+  type ConfigProvider interface {
+      Get(key string) any
+      Unmarshal(v any) error
+      GetString(key string) string
+      GetInt(key string) int
+      GetBool(key string) bool
+  }
+  ```
+- [ ] Implement `internal/config/config.go` using Viper:
+  - Load `config/default.yaml` as baseline
+  - Merge environment-specific YAML (development/production)
+  - Apply environment variable overrides
+  - Support secret manager integration (placeholder for Phase 6)
+- [ ] Create `config/default.yaml` with basic structure:
+  ```yaml
+  environment: development
+  server:
+    port: 8080
+    host: "0.0.0.0"
+  database:
+    driver: "postgres"
+    dsn: ""
+  logging:
+    level: "info"
+    format: "json"
+  ```
+- [ ] Add `internal/config/loader.go` with `LoadConfig()` function
+
+#### 0.3 Logging Foundation
+- [ ] Install `go.uber.org/zap`
+- [ ] Create `pkg/logger/logger.go` interface:
+  ```go
+  type Logger interface {
+      Debug(msg string, fields ...Field)
+      Info(msg string, fields ...Field)
+      Warn(msg string, fields ...Field)
+      Error(msg string, fields ...Field)
+      With(fields ...Field) Logger
+  }
+  ```
+- [ ] Implement `internal/logger/zap_logger.go`:
+  - Structured JSON logging
+  - Configurable log levels
+  - Request-scoped fields support
+  - Export global logger via `pkg/logger`
+- [ ] Add request ID middleware helper (Gin middleware)
+
+#### 0.4 Basic CI/CD Pipeline
+- [ ] Create `.github/workflows/ci.yml`:
+  - Go 1.22 setup
+  - Module caching
+  - Linting (golangci-lint or staticcheck)
+  - Unit tests (basic skeleton)
+  - Build binary
+- [ ] Add `Makefile` with common commands:
+  - `make test` - run tests
+  - `make lint` - run linter
+  - `make build` - build binary
+  - `make docker-build` - build Docker image
+
+#### 0.5 Dependency Injection Setup
+- [ ] Install `go.uber.org/fx`
+- [ ] Create `internal/di/container.go`:
+  - Initialize fx container
+  - Register Config and Logger providers
+  - Basic lifecycle hooks
+- [ ] Create `cmd/platform/main.go` skeleton:
+  - Load config
+  - Initialize DI container
+  - Start minimal HTTP server (placeholder)
+
+### Deliverables
+- ✅ Repository structure in place
+- ✅ Configuration system loads YAML files and env vars
+- ✅ Structured logging works
+- ✅ CI pipeline runs linting and builds binary
+- ✅ Basic DI container initialized
+
+### Acceptance Criteria
+- `go build ./cmd/platform` succeeds
+- `go test ./...` runs (even if tests are empty)
+- CI pipeline passes on empty commit
+- Config loads from `config/default.yaml`
+
+---
+
+## Phase 1: Core Kernel & Infrastructure (Week 2-3)
+
+### Objectives
+- Implement dependency injection container
+- Set up database (Ent ORM)
+- Create health and metrics endpoints
+- Implement error bus
+- Add basic HTTP server with middleware
+
+### Tasks
+
+#### 1.1 Dependency Injection Container
+- [ ] Extend `internal/di/container.go`:
+  - Register all core services
+  - Provide lifecycle management via fx
+  - Support service overrides
+- [ ] Create `internal/di/providers.go`:
+  - `ProvideConfig()` - config provider
+  - `ProvideLogger()` - logger
+  - `ProvideDatabase()` - Ent client (after 1.2)
+  - `ProvideHealthCheckers()` - health check registry
+  - `ProvideMetrics()` - Prometheus registry
+  - `ProvideErrorBus()` - error bus
+- [ ] Add `internal/di/core_module.go`:
+  - Export `CoreModule` fx.Option that provides all core services
+
+#### 1.2 Database Setup (Ent)
+- [ ] Install `entgo.io/ent/cmd/ent`
+- [ ] Initialize Ent schema:
+  ```bash
+  go run entgo.io/ent/cmd/ent init User Role Permission AuditLog
+  ```
+- [ ] Define core entities in `internal/ent/schema/`:
+  - `user.go`: ID, email, password_hash, verified, created_at, updated_at
+  - `role.go`: ID, name, description, created_at
+  - `permission.go`: ID, name (string format: "module.resource.action")
+  - `audit_log.go`: ID, actor_id, action, target_id, metadata (JSON), timestamp
+  - `role_permissions.go`: Many-to-many relationship
+  - `user_roles.go`: Many-to-many relationship
+- [ ] Generate Ent code: `go generate ./internal/ent`
+- [ ] Create `internal/infra/database/client.go`:
+  - `NewEntClient(dsn string) (*ent.Client, error)`
+  - Connection pooling configuration
+  - Migration runner wrapper
+- [ ] Add database config to `config/default.yaml`
+
+#### 1.3 Health & Metrics
+- [ ] Install `github.com/prometheus/client_golang/prometheus`
+- [ ] Install `github.com/heptiolabs/healthcheck` (optional, or custom)
+- [ ] Create `pkg/health/health.go` interface:
+  ```go
+  type HealthChecker interface {
+      Check(ctx context.Context) error
+  }
+  ```
+- [ ] Implement `internal/health/registry.go`:
+  - Registry of health checkers
+  - `/healthz` endpoint (liveness)
+  - `/ready` endpoint (readiness with DB check)
+- [ ] Create `internal/metrics/metrics.go`:
+  - HTTP request duration histogram
+  - HTTP request counter
+  - Database query duration (via Ent interceptor)
+  - Error counter
+- [ ] Add `/metrics` endpoint (Prometheus format)
+- [ ] Register endpoints in main HTTP router
+
+#### 1.4 Error Bus
+- [ ] Create `pkg/errorbus/errorbus.go` interface:
+  ```go
+  type ErrorPublisher interface {
+      Publish(err error)
+  }
+  ```
+- [ ] Implement `internal/errorbus/channel_bus.go`:
+  - Channel-based error bus
+  - Background goroutine consumes errors
+  - Log all errors
+  - Optional: Sentry integration (Phase 6)
+- [ ] Add panic recovery middleware that publishes to error bus
+- [ ] Register error bus in DI container
+
+#### 1.5 HTTP Server Foundation
+- [ ] Install `github.com/gin-gonic/gin`
+- [ ] Create `internal/server/server.go`:
+  - Initialize Gin router
+  - Add middleware:
+    - Request ID generator
+    - Structured logging
+    - Panic recovery → error bus
+    - Prometheus metrics
+    - CORS (configurable)
+  - Register core routes:
+    - `GET /healthz`
+    - `GET /ready`
+    - `GET /metrics`
+- [ ] Wire HTTP server into fx lifecycle:
+  - Start on `OnStart`
+  - Graceful shutdown on `OnStop`
+- [ ] Update `cmd/platform/main.go` to use fx lifecycle
+
+#### 1.6 OpenTelemetry Setup
+- [ ] Install OpenTelemetry packages:
+  - `go.opentelemetry.io/otel`
+  - `go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp`
+- [ ] Create `internal/observability/tracer.go`:
+  - Initialize OTEL TracerProvider
+  - Export to stdout (development) or OTLP (production)
+- [ ] Add HTTP instrumentation middleware
+- [ ] Add trace context propagation to requests
+
+### Deliverables
+- ✅ DI container with all core services
+- ✅ Database client with Ent schema
+- ✅ Health and metrics endpoints functional
+- ✅ Error bus captures and logs errors
+- ✅ HTTP server with middleware stack
+- ✅ Basic observability with OpenTelemetry
+
+### Acceptance Criteria
+- `GET /healthz` returns 200
+- `GET /ready` checks DB connectivity
+- `GET /metrics` exposes Prometheus metrics
+- Panic recovery logs errors via error bus
+- Database migrations run on startup
+- HTTP requests are traced with OpenTelemetry
+
+---
+
+## Phase 2: Authentication & Authorization (Week 3-4)
+
+### Objectives
+- Implement JWT authentication
+- Create identity management (User CRUD)
+- Build role and permission system
+- Add authorization middleware
+- Implement audit logging
+
+### Tasks
+
+#### 2.1 Authentication (JWT)
+- [ ] Install `github.com/golang-jwt/jwt/v5`
+- [ ] Create `pkg/auth/auth.go` interfaces:
+  ```go
+  type Authenticator interface {
+      GenerateToken(userID string, roles []string, tenantID string) (string, error)
+      VerifyToken(token string) (*TokenClaims, error)
+  }
+  
+  type TokenClaims struct {
+      UserID   string
+      Roles    []string
+      TenantID string
+      ExpiresAt time.Time
+  }
+  ```
+- [ ] Implement `internal/auth/jwt_auth.go`:
+  - Generate access tokens (short-lived, 15min)
+  - Generate refresh tokens (long-lived, 7 days)
+  - Verify token signature and expiration
+  - Extract claims
+- [ ] Create `internal/auth/middleware.go`:
+  - Extract JWT from `Authorization: Bearer <token>` header
+  - Verify token
+  - Inject `User` into `context.Context`
+  - Helper: `auth.FromContext(ctx) *User`
+- [ ] Add login endpoint: `POST /api/v1/auth/login`
+  - Validate credentials
+  - Return access + refresh tokens
+- [ ] Add refresh endpoint: `POST /api/v1/auth/refresh`
+  - Validate refresh token
+  - Issue new access token
+
+#### 2.2 Identity Management
+- [ ] Create `pkg/identity/identity.go` interfaces:
+  ```go
+  type UserRepository interface {
+      FindByID(ctx context.Context, id string) (*User, error)
+      FindByEmail(ctx context.Context, email string) (*User, error)
+      Create(ctx context.Context, u *User) error
+      Update(ctx context.Context, u *User) error
+      Delete(ctx context.Context, id string) error
+  }
+  
+  type UserService interface {
+      Register(ctx context.Context, email, password string) (*User, error)
+      VerifyEmail(ctx context.Context, token string) error
+      ResetPassword(ctx context.Context, email string) error
+      ChangePassword(ctx context.Context, userID, oldPassword, newPassword string) error
+  }
+  ```
+- [ ] Implement `internal/identity/user_repo.go` using Ent:
+  - CRUD operations
+  - Password hashing (bcrypt or argon2)
+  - Email verification flow
+- [ ] Implement `internal/identity/user_service.go`:
+  - User registration with email verification
+  - Password reset flow (token-based)
+  - Password change
+  - Email verification
+- [ ] Add endpoints:
+  - `POST /api/v1/users` - Register
+  - `GET /api/v1/users/:id` - Get user
+  - `PUT /api/v1/users/:id` - Update user
+  - `POST /api/v1/users/verify-email` - Verify email
+  - `POST /api/v1/users/reset-password` - Request reset
+  - `POST /api/v1/users/change-password` - Change password
+
+#### 2.3 Roles & Permissions
+- [ ] Create `pkg/perm/perm.go`:
+  ```go
+  type Permission string
+  
+  // Core permissions
+  var (
+      SystemHealthCheck Permission = "system.health.check"
+      UserCreate        Permission = "user.create"
+      UserRead          Permission = "user.read"
+      UserUpdate        Permission = "user.update"
+      UserDelete        Permission = "user.delete"
+      RoleCreate        Permission = "role.create"
+      RoleRead          Permission = "role.read"
+      RoleUpdate        Permission = "role.update"
+      RoleDelete        Permission = "role.delete"
+  )
+  ```
+- [ ] Create `pkg/perm/resolver.go` interface:
+  ```go
+  type PermissionResolver interface {
+      HasPermission(ctx context.Context, userID string, perm Permission) (bool, error)
+      GetUserPermissions(ctx context.Context, userID string) ([]Permission, error)
+  }
+  ```
+- [ ] Implement `internal/perm/in_memory_resolver.go`:
+  - Load user roles from DB
+  - Load role permissions from DB
+  - Check if user has specific permission
+  - Cache permission lookups (optional)
+- [ ] Create `pkg/auth/authz.go` interface:
+  ```go
+  type Authorizer interface {
+      Authorize(ctx context.Context, perm Permission) error
+  }
+  ```
+- [ ] Implement `internal/auth/rbac_authorizer.go`:
+  - Extract user from context
+  - Check permission via PermissionResolver
+  - Return error if unauthorized
+- [ ] Create authorization middleware:
+  - Decorator pattern: `RequirePermission(perm Permission) gin.HandlerFunc`
+  - Use with route registration
+
+#### 2.4 Role Management API
+- [ ] Create `internal/identity/role_repo.go`:
+  - CRUD for roles
+  - Assign permissions to roles
+  - Assign roles to users
+- [ ] Add endpoints:
+  - `POST /api/v1/roles` - Create role
+  - `GET /api/v1/roles` - List roles
+  - `GET /api/v1/roles/:id` - Get role
+  - `PUT /api/v1/roles/:id` - Update role
+  - `DELETE /api/v1/roles/:id` - Delete role
+  - `POST /api/v1/roles/:id/permissions` - Assign permissions
+  - `POST /api/v1/users/:id/roles` - Assign roles to user
+
+#### 2.5 Audit Logging
+- [ ] Create `pkg/audit/audit.go` interface:
+  ```go
+  type Auditor interface {
+      Record(ctx context.Context, act AuditAction) error
+  }
+  
+  type AuditAction struct {
+      ActorID  string
+      Action   string
+      TargetID string
+      Metadata map[string]any
+  }
+  ```
+- [ ] Implement `internal/audit/ent_auditor.go`:
+  - Write to `audit_log` table
+  - Capture actor from context
+  - Include request ID, IP address, user agent
+- [ ] Add audit middleware:
+  - Intercept all authenticated requests
+  - Record action (method + path)
+  - Store in audit log
+- [ ] Integrate with auth endpoints:
+  - Log login attempts (success/failure)
+  - Log password changes
+  - Log role assignments
+
+#### 2.6 Seed Data
+- [ ] Create `internal/seed/seed.go`:
+  - Create default admin user (if doesn't exist)
+  - Create default roles (admin, user, guest)
+  - Assign permissions to roles
+  - Script: `go run cmd/seed/main.go`
+
+### Deliverables
+- ✅ JWT authentication with access/refresh tokens
+- ✅ User CRUD with email verification
+- ✅ Role and permission management
+- ✅ Authorization middleware
+- ✅ Audit logging for all actions
+- ✅ Seed script for initial data
+
+### Acceptance Criteria
+- User can register and login
+- JWT tokens are validated on protected routes
+- Users without permission get 403
+- All actions are logged in audit table
+- Admin can create roles and assign permissions
+- Integration test: user without permission cannot access protected resource
+
+---
+
+## Phase 3: Module Framework (Week 4-5)
+
+### Objectives
+- Define module interface and registration system
+- Implement static module registry
+- Create permission code generation tool
+- Build module loader (support both static and plugin modes)
+- Add module discovery and initialization
+
+### Tasks
+
+#### 3.1 Module Interface
+- [ ] Create `pkg/module/module.go`:
+  ```go
+  type IModule interface {
+      Name() string
+      Version() string
+      Dependencies() []string
+      Init() fx.Option
+      Migrations() []func(*ent.Client) error
+  }
+  ```
+- [ ] Create `pkg/module/manifest.go`:
+  ```go
+  type Manifest struct {
+      Name         string
+      Version      string
+      Dependencies []string
+      Permissions  []string
+      Routes       []Route
+  }
+  ```
+- [ ] Define `module.yaml` schema (used for code generation)
+
+#### 3.2 Static Module Registry
+- [ ] Create `internal/registry/registry.go`:
+  - Thread-safe module map
+  - `Register(m IModule)` function
+  - `All() []IModule` function
+  - `Get(name string) (IModule, error)` function
+- [ ] Add registration validation:
+  - Check dependencies are satisfied
+  - Check for duplicate names
+  - Validate version compatibility
+
+#### 3.3 Permission Code Generation
+- [ ] Create `scripts/generate-permissions.go`:
+  - Scan all `modules/*/module.yaml` files
+  - Extract permissions from manifests
+  - Generate `pkg/perm/generated.go`:
+    ```go
+    // Code generated by generate-permissions. DO NOT EDIT.
+    var (
+        BlogPostCreate Permission = "blog.post.create"
+        BlogPostRead   Permission = "blog.post.read"
+        // ...
+    )
+    ```
+- [ ] Add `//go:generate` directive to `pkg/perm/perm.go`
+- [ ] Update `Makefile` with `make generate` command
+
+#### 3.4 Module Loader
+- [ ] Create `internal/pluginloader/loader.go`:
+  - Support static registration (preferred)
+  - Optional: support Go plugin loading (`.so` files)
+  - Scan `modules/*/module.yaml` for discovery
+  - Load modules in dependency order
+- [ ] Implement `internal/pluginloader/static_loader.go`:
+  - Import modules via `import _ "github.com/yourorg/blog"` (side-effect registration)
+  - Collect all registered modules
+- [ ] Implement `internal/pluginloader/plugin_loader.go` (optional):
+  - Scan `./plugins/*.so`
+  - Load via `plugin.Open()`
+  - Extract `Module` symbol
+  - Validate version compatibility
+
+#### 3.5 Module Initialization
+- [ ] Create `internal/module/initializer.go`:
+  - Collect all registered modules
+  - Resolve dependency order (topological sort)
+  - Initialize each module's `Init()` fx.Option
+  - Merge all options into main fx container
+- [ ] Run migrations:
+  - Collect all module migrations
+  - Run core migrations first
+  - Run module migrations in dependency order
+  - Handle migration errors gracefully
+
+#### 3.6 Module Lifecycle Hooks
+- [ ] Extend `pkg/module/module.go`:
+  ```go
+  type IModule interface {
+      // ... existing methods
+      OnStart(ctx context.Context) error  // Optional
+      OnStop(ctx context.Context) error  // Optional
+  }
+  ```
+- [ ] Integrate with fx.Lifecycle:
+  - Call `OnStart` during app startup
+  - Call `OnStop` during graceful shutdown
+
+#### 3.7 Module CLI Tool
+- [ ] Create `cmd/platformctl/main.go`:
+  - `platformctl modules list` - List all loaded modules
+  - `platformctl modules validate` - Validate module dependencies
+  - `platformctl modules test <module>` - Test module loading
+- [ ] Add to `Makefile`: `make install-cli`
+
+### Deliverables
+- ✅ Module interface and registration system
+- ✅ Static module registry working
+- ✅ Permission code generation tool
+- ✅ Module loader with dependency resolution
+- ✅ Module initialization in main app
+- ✅ CLI tool for module management
+
+### Acceptance Criteria
+- Modules can register via `registry.Register()`
+- Permission constants are generated from `module.yaml`
+- Modules load in correct dependency order
+- Module migrations run on startup
+- `platformctl modules list` shows all modules
+- Integration test: load multiple modules and verify initialization
+
+---
+
+## Phase 4: Sample Feature Module (Blog) (Week 5-6)
+
+### Objectives
+- Create a complete sample module (Blog) to demonstrate the framework
+- Show how to add routes, permissions, database entities, and services
+- Provide reference implementation for future developers
+
+### Tasks
+
+#### 4.1 Blog Module Structure
+- [ ] Create `modules/blog/` directory:
+  ```
+  modules/blog/
+  ├── go.mod
+  ├── module.yaml
+  ├── internal/
+  │   ├── api/
+  │   │   └── handler.go
+  │   ├── domain/
+  │   │   ├── post.go
+  │   │   └── post_repo.go
+  │   └── service/
+  │       └── post_service.go
+  └── pkg/
+      └── module.go
+  ```
+- [ ] Initialize `go.mod`:
+  ```bash
+  cd modules/blog
+  go mod init github.com/yourorg/blog
+  ```
+
+#### 4.2 Module Manifest
+- [ ] Create `modules/blog/module.yaml`:
+  ```yaml
+  name: blog
+  version: 0.1.0
+  dependencies:
+    - core >= 1.0.0
+  permissions:
+    - blog.post.create
+    - blog.post.read
+    - blog.post.update
+    - blog.post.delete
+  routes:
+    - method: POST
+      path: /api/v1/blog/posts
+      permission: blog.post.create
+    - method: GET
+      path: /api/v1/blog/posts/:id
+      permission: blog.post.read
+    - method: PUT
+      path: /api/v1/blog/posts/:id
+      permission: blog.post.update
+    - method: DELETE
+      path: /api/v1/blog/posts/:id
+      permission: blog.post.delete
+    - method: GET
+      path: /api/v1/blog/posts
+      permission: blog.post.read
+  ```
+
+#### 4.3 Blog Domain Model
+- [ ] Create `modules/blog/internal/domain/post.go`:
+  ```go
+  type Post struct {
+      ID        string
+      Title     string
+      Content   string
+      AuthorID  string
+      CreatedAt time.Time
+      UpdatedAt time.Time
+  }
+  ```
+- [ ] Create Ent schema `modules/blog/internal/ent/schema/post.go`:
+  - Fields: title, content, author_id (FK to user)
+  - Indexes: author_id, created_at
+- [ ] Generate Ent code for blog module
+
+#### 4.4 Blog Repository
+- [ ] Create `modules/blog/internal/domain/post_repo.go`:
+  ```go
+  type PostRepository interface {
+      Create(ctx context.Context, p *Post) (*Post, error)
+      FindByID(ctx context.Context, id string) (*Post, error)
+      FindByAuthor(ctx context.Context, authorID string) ([]*Post, error)
+      Update(ctx context.Context, p *Post) error
+      Delete(ctx context.Context, id string) error
+  }
+  ```
+- [ ] Implement using Ent client (shared from core)
+
+#### 4.5 Blog Service
+- [ ] Create `modules/blog/internal/service/post_service.go`:
+  - Business logic for creating/updating posts
+  - Validation (title length, content requirements)
+  - Authorization checks (author can only update own posts)
+  - Integration with audit system
+
+#### 4.6 Blog API Handlers
+- [ ] Create `modules/blog/internal/api/handler.go`:
+  - `POST /api/v1/blog/posts` - Create post
+  - `GET /api/v1/blog/posts/:id` - Get post
+  - `GET /api/v1/blog/posts` - List posts (with pagination)
+  - `PUT /api/v1/blog/posts/:id` - Update post
+  - `DELETE /api/v1/blog/posts/:id` - Delete post
+- [ ] Use authorization middleware:
+  ```go
+  grp.Use(auth.RequirePermission(perm.BlogPostCreate))
+  ```
+- [ ] Register handlers in module's `Init()`
+
+#### 4.7 Blog Module Implementation
+- [ ] Create `modules/blog/pkg/module.go`:
+  ```go
+  type BlogModule struct{}
+  
+  func (b BlogModule) Name() string { return "blog" }
+  func (b BlogModule) Version() string { return "0.1.0" }
+  func (b BlogModule) Dependencies() []string { return nil }
+  func (b BlogModule) Init() fx.Option {
+      return fx.Options(
+          fx.Provide(NewPostRepo),
+          fx.Provide(NewPostService),
+          fx.Invoke(RegisterHandlers),
+      )
+  }
+  func (b BlogModule) Migrations() []func(*ent.Client) error {
+      return []func(*ent.Client) error{
+          func(c *ent.Client) error {
+              return c.Schema.Create(context.Background())
+          },
+      }
+  }
+  
+  var Module BlogModule
+  
+  func init() {
+      registry.Register(Module)
+  }
+  ```
+
+#### 4.8 Integration
+- [ ] Update main `go.mod` to include blog module:
+  ```go
+  replace github.com/yourorg/blog => ./modules/blog
+  ```
+- [ ] Import blog module in `cmd/platform/main.go`:
+  ```go
+  import _ "github.com/yourorg/blog/pkg"
+  ```
+- [ ] Run permission generation: `make generate`
+- [ ] Verify blog permissions are generated
+
+#### 4.9 Tests
+- [ ] Create integration test `modules/blog/internal/api/handler_test.go`:
+  - Test creating post with valid permission
+  - Test creating post without permission (403)
+  - Test updating own post vs other's post
+  - Test pagination
+- [ ] Add unit tests for service and repository
+
+### Deliverables
+- ✅ Complete Blog module with CRUD operations
+- ✅ Module registered and loaded by core
+- ✅ Permissions generated and used
+- ✅ Routes protected with authorization
+- ✅ Database migrations run
+- ✅ Integration tests passing
+
+### Acceptance Criteria
+- Blog module loads on platform startup
+- `POST /api/v1/blog/posts` requires `blog.post.create` permission
+- User can create, read, update, delete posts
+- Authorization enforced (users can only edit own posts)
+- Integration test: full CRUD flow works
+- Audit logs record all blog actions
+
+---
+
+## Phase 5: Infrastructure Adapters (Week 6-7)
+
+### Objectives
+- Implement infrastructure adapters (cache, queue, blob storage, email)
+- Make adapters swappable via interfaces
+- Add scheduler/background jobs system
+- Implement event bus (in-process and Kafka)
+
+### Tasks
+
+#### 5.1 Cache (Redis)
+- [ ] Install `github.com/redis/go-redis/v9`
+- [ ] Create `pkg/infra/cache/cache.go` interface:
+  ```go
+  type Cache interface {
+      Get(ctx context.Context, key string) ([]byte, error)
+      Set(ctx context.Context, key string, value []byte, ttl time.Duration) error
+      Delete(ctx context.Context, key string) error
+  }
+  ```
+- [ ] Implement `internal/infra/cache/redis_cache.go`
+- [ ] Add Redis config to `config/default.yaml`
+- [ ] Register in DI container
+- [ ] Add cache middleware for selected routes (optional)
+
+#### 5.2 Event Bus
+- [ ] Create `pkg/eventbus/eventbus.go` interface:
+  ```go
+  type EventBus interface {
+      Publish(ctx context.Context, topic string, event Event) error
+      Subscribe(topic string, handler EventHandler) error
+  }
+  ```
+- [ ] Implement `internal/infra/bus/inprocess_bus.go`:
+  - Channel-based in-process bus
+  - Used for testing and development
+- [ ] Implement `internal/infra/bus/kafka_bus.go`:
+  - Install `github.com/segmentio/kafka-go`
+  - Producer for publishing
+  - Consumer groups for subscribing
+  - Error handling and retries
+- [ ] Add Kafka config to `config/default.yaml`
+- [ ] Register bus in DI container (switchable via config)
+- [ ] Add core events:
+  - `platform.user.created`
+  - `platform.user.updated`
+  - `platform.role.assigned`
+  - `platform.permission.granted`
+
+#### 5.3 Blob Storage
+- [ ] Install `github.com/aws/aws-sdk-go-v2/service/s3`
+- [ ] Create `pkg/infra/blob/blob.go` interface:
+  ```go
+  type BlobStore interface {
+      Upload(ctx context.Context, key string, data []byte) error
+      Download(ctx context.Context, key string) ([]byte, error)
+      Delete(ctx context.Context, key string) error
+      GetSignedURL(ctx context.Context, key string, ttl time.Duration) (string, error)
+  }
+  ```
+- [ ] Implement `internal/infra/blob/s3_store.go`
+- [ ] Add S3 config to `config/default.yaml`
+- [ ] Register in DI container
+- [ ] Add file upload endpoint: `POST /api/v1/files/upload`
+
+#### 5.4 Email Notification
+- [ ] Install `github.com/go-mail/mail`
+- [ ] Create `pkg/notification/notification.go` interface:
+  ```go
+  type Notifier interface {
+      SendEmail(ctx context.Context, to, subject, body string) error
+      SendSMS(ctx context.Context, to, message string) error
+  }
+  ```
+- [ ] Implement `internal/infra/email/smtp_notifier.go`:
+  - SMTP configuration
+  - HTML email support
+  - Templates for common emails (verification, password reset)
+- [ ] Add email config to `config/default.yaml`
+- [ ] Integrate with identity service:
+  - Send verification email on registration
+  - Send password reset email
+- [ ] Register in DI container
+
+#### 5.5 Scheduler & Background Jobs
+- [ ] Install `github.com/robfig/cron/v3` and `github.com/hibiken/asynq`
+- [ ] Create `pkg/scheduler/scheduler.go` interface:
+  ```go
+  type Scheduler interface {
+      Cron(spec string, job JobFunc) error
+      Enqueue(queue string, payload any) error
+  }
+  ```
+- [ ] Implement `internal/infra/scheduler/asynq_scheduler.go`:
+  - Redis-backed job queue
+  - Cron jobs for periodic tasks
+  - Job retries and backoff
+  - Job status tracking
+- [ ] Create `internal/infra/scheduler/job_registry.go`:
+  - Register jobs from modules
+  - Start job processor on app startup
+- [ ] Add example jobs:
+  - Cleanup expired tokens (daily)
+  - Send digest emails (weekly)
+- [ ] Add job monitoring endpoint: `GET /api/v1/jobs/status`
+
+#### 5.6 Secret Store Integration
+- [ ] Create `pkg/infra/secret/secret.go` interface:
+  ```go
+  type SecretStore interface {
+      GetSecret(ctx context.Context, key string) (string, error)
+  }
+  ```
+- [ ] Implement `internal/infra/secret/vault_store.go` (HashiCorp Vault):
+  - Install `github.com/hashicorp/vault/api`
+  - Support KV v2 secrets
+- [ ] Implement `internal/infra/secret/aws_secrets.go` (AWS Secrets Manager):
+  - Install `github.com/aws/aws-sdk-go-v2/service/secretsmanager`
+- [ ] Integrate with config loader:
+  - Overlay secrets on top of file/env config
+  - Load secrets lazily (cache)
+- [ ] Register in DI container (optional, via config)
+
+#### 5.7 Multi-tenancy Support (Optional)
+- [ ] Create `pkg/tenant/tenant.go` interface:
+  ```go
+  type TenantResolver interface {
+      Resolve(ctx context.Context) (string, error)
+  }
+  ```
+- [ ] Implement `internal/tenant/resolver.go`:
+  - Extract from header: `X-Tenant-ID`
+  - Extract from subdomain
+  - Extract from JWT claim
+- [ ] Add tenant middleware:
+  - Resolve tenant ID
+  - Inject into context
+  - Helper: `tenant.FromContext(ctx) string`
+- [ ] Update Ent queries to filter by tenant_id:
+  - Add interceptor to Ent client
+  - Automatically add `WHERE tenant_id = ?` to queries
+- [ ] Update User entity to include tenant_id
+
+### Deliverables
+- ✅ Cache adapter (Redis) working
+- ✅ Event bus (in-process and Kafka) functional
+- ✅ Blob storage (S3) adapter
+- ✅ Email notification system
+- ✅ Scheduler and background jobs
+- ✅ Secret store integration (optional)
+- ✅ Multi-tenancy support (optional)
+
+### Acceptance Criteria
+- Cache stores and retrieves data correctly
+- Events are published and consumed
+- Files can be uploaded and downloaded
+- Email notifications are sent
+- Background jobs run on schedule
+- Integration test: full infrastructure stack works
+
+---
+
+## Phase 6: Observability & Production Readiness (Week 7-8)
+
+### Objectives
+- Enhance observability with full OpenTelemetry integration
+- Add comprehensive error reporting (Sentry)
+- Create Grafana dashboards
+- Improve logging with request correlation
+- Add rate limiting and security hardening
+
+### Tasks
+
+#### 6.1 OpenTelemetry Enhancement
+- [ ] Complete OpenTelemetry setup:
+  - Export traces to Jaeger/OTLP collector
+  - Add database instrumentation (Ent interceptor)
+  - Add Kafka instrumentation
+  - Add Redis instrumentation
+- [ ] Create custom spans:
+  - Module initialization spans
+  - Background job spans
+  - Event publishing spans
+- [ ] Add trace context propagation:
+  - Include trace ID in logs
+  - Propagate across HTTP calls
+  - Include in error reports
+
+#### 6.2 Error Reporting (Sentry)
+- [ ] Install `github.com/getsentry/sentry-go`
+- [ ] Integrate with error bus:
+  - Send errors to Sentry
+  - Include trace ID in Sentry events
+  - Add user context (user ID, email)
+  - Add module context (module name)
+- [ ] Add Sentry middleware:
+  - Capture panics
+  - Capture HTTP errors (4xx, 5xx)
+- [ ] Configure Sentry DSN via config
+
+#### 6.3 Logging Enhancements
+- [ ] Add request correlation:
+  - Generate unique request ID per request
+  - Include in all logs
+  - Return in response headers (`X-Request-ID`)
+- [ ] Add structured fields:
+  - `user_id` from context
+  - `tenant_id` from context
+  - `module` name for module logs
+  - `trace_id` from OpenTelemetry
+- [ ] Create log aggregation config:
+  - JSON format for production
+  - Human-readable for development
+  - Support for Loki/CloudWatch/ELK
+
+#### 6.4 Prometheus Metrics Expansion
+- [ ] Add more metrics:
+  - Database connection pool stats
+  - Cache hit/miss ratio
+  - Event bus publish/consume rates
+  - Background job execution times
+  - Module-specific metrics (via module interface)
+- [ ] Create metric labels:
+  - `module` label for module metrics
+  - `tenant_id` label (if multi-tenant)
+  - `status` label for error rates
+
+#### 6.5 Grafana Dashboards
+- [ ] Create `ops/grafana/dashboards/`:
+  - `platform-overview.json` - Overall health
+  - `http-metrics.json` - HTTP request metrics
+  - `database-metrics.json` - Database performance
+  - `module-metrics.json` - Per-module metrics
+  - `error-rates.json` - Error tracking
+- [ ] Document dashboard setup in `docs/operations.md`
+
+#### 6.6 Rate Limiting
+- [ ] Install `github.com/ulule/limiter/v3`
+- [ ] Create rate limit middleware:
+  - Per-user rate limiting
+  - Per-IP rate limiting
+  - Configurable limits per endpoint
+- [ ] Add rate limit config:
+  ```yaml
+  rate_limiting:
+    enabled: true
+    per_user: 100/minute
+    per_ip: 1000/minute
+  ```
+- [ ] Return `X-RateLimit-*` headers
+
+#### 6.7 Security Hardening
+- [ ] Add security headers middleware:
+  - `X-Content-Type-Options: nosniff`
+  - `X-Frame-Options: DENY`
+  - `X-XSS-Protection: 1; mode=block`
+  - `Strict-Transport-Security` (if HTTPS)
+  - `Content-Security-Policy`
+- [ ] Add request size limits:
+  - Max body size (10MB default)
+  - Max header size
+- [ ] Add input validation:
+  - Use `github.com/go-playground/validator`
+  - Validate all request bodies
+  - Sanitize user inputs
+- [ ] Add SQL injection protection:
+  - Use parameterized queries (Ent already does this)
+  - Add linter rule to prevent raw SQL
+
+#### 6.8 Performance Optimization
+- [ ] Add database connection pooling:
+  - Configure max connections
+  - Configure idle timeout
+  - Monitor pool stats
+- [ ] Add query optimization:
+  - Add indexes for common queries
+  - Use database query logging (development)
+  - Add slow query detection
+- [ ] Add response compression:
+  - Gzip middleware for large responses
+- [ ] Add caching strategy:
+  - Cache frequently accessed data (user permissions, roles)
+
+### Deliverables
+- ✅ Full OpenTelemetry integration
+- ✅ Sentry error reporting
+- ✅ Enhanced logging with correlation
+- ✅ Comprehensive Prometheus metrics
+- ✅ Grafana dashboards
+- ✅ Rate limiting
+- ✅ Security hardening
+- ✅ Performance optimizations
+
+### Acceptance Criteria
+- Traces are exported and visible in Jaeger
+- Errors are reported to Sentry with context
+- Logs include request IDs and trace IDs
+- Metrics are exposed and scraped by Prometheus
+- Rate limiting prevents abuse
+- Security headers are present
+- Performance meets SLA (< 100ms p95 for auth endpoints)
+
+---
+
+## Phase 7: Testing, Documentation & CI/CD (Week 8-9)
+
+### Objectives
+- Comprehensive test coverage (unit, integration, contract)
+- Complete documentation
+- Production-ready CI/CD pipeline
+- Docker images and deployment guides
+
+### Tasks
+
+#### 7.1 Unit Tests
+- [ ] Achieve >80% code coverage for core modules:
+  - Config loader
+  - Logger
+  - Auth service
+  - Permission resolver
+  - Module registry
+- [ ] Use `github.com/stretchr/testify` for assertions
+- [ ] Use `github.com/golang/mock` or `mockery` for mocks
+- [ ] Add test helpers:
+  - `testutil.NewTestDB()` - In-memory SQLite for tests
+  - `testutil.NewTestUser()` - Create test user
+  - `testutil.NewTestContext()` - Context with user
+
+#### 7.2 Integration Tests
+- [ ] Install `github.com/testcontainers/testcontainers-go`
+- [ ] Create integration test suite:
+  - Full HTTP request flow
+  - Database operations
+  - Event bus publishing/consuming
+  - Background job execution
+- [ ] Test scenarios:
+  - User registration → login → API access
+  - Role assignment → permission check
+  - Module loading and initialization
+  - Multi-module interaction
+- [ ] Create `docker-compose.test.yml`:
+  - PostgreSQL
+  - Redis
+  - Kafka (optional)
+- [ ] Add test tags: `//go:build integration`
+
+#### 7.3 Contract Tests
+- [ ] Install `github.com/pact-foundation/pact-go` (optional)
+- [ ] Create API contract tests:
+  - Verify API responses match OpenAPI spec
+  - Test backward compatibility
+- [ ] Use OpenAPI validator:
+  - Install `github.com/getkin/kin-openapi`
+  - Validate request/response against OpenAPI spec
+  - Generate OpenAPI spec from code annotations
+
+#### 7.4 Load Testing
+- [ ] Create `perf/` directory with k6 scripts:
+  - `perf/auth-load.js` - Login endpoint load test
+  - `perf/api-load.js` - General API load test
+- [ ] Document performance benchmarks:
+  - Request latency (p50, p95, p99)
+  - Throughput (requests/second)
+  - Resource usage (CPU, memory)
+
+#### 7.5 Documentation
+- [ ] Create `README.md`:
+  - Quick start guide
+  - Architecture overview
+  - Installation instructions
+  - Development setup
+- [ ] Create `docs/architecture.md`:
+  - System architecture diagram
+  - Module system explanation
+  - Extension points
+- [ ] Create `docs/extension-points.md`:
+  - How to create a module
+  - Permission system
+  - Event bus usage
+  - Background jobs
+- [ ] Create `docs/api.md`:
+  - API endpoints documentation
+  - Authentication flow
+  - Error codes
+- [ ] Create `docs/operations.md`:
+  - Deployment guide
+  - Monitoring setup
+  - Troubleshooting
+  - Grafana dashboards
+- [ ] Add code examples:
+  - `examples/` directory with sample modules
+  - Code comments and godoc
+
+#### 7.6 CI/CD Pipeline Enhancement
+- [ ] Update `.github/workflows/ci.yml`:
+  - Run unit tests with coverage
+  - Run integration tests (with testcontainers)
+  - Run linters (golangci-lint, gosec)
+  - Generate coverage report
+  - Upload artifacts
+- [ ] Add release workflow:
+  - Semantic versioning
+  - Tag releases
+  - Build and push Docker images
+  - Generate changelog
+- [ ] Add security scanning:
+  - `gosec` for security issues
+  - Dependabot for dependency updates
+  - Trivy for container scanning
+
+#### 7.7 Docker Images
+- [ ] Create multi-stage `Dockerfile`:
+  ```dockerfile
+  # Build stage
+  FROM golang:1.22-alpine AS builder
+  # ... build commands
+  
+  # Runtime stage
+  FROM gcr.io/distroless/static-debian12
+  # ... copy binary
+  ```
+- [ ] Create `docker-compose.yml` for development:
+  - Platform service
+  - PostgreSQL
+  - Redis
+  - Kafka (optional)
+- [ ] Create `docker-compose.prod.yml` for production
+- [ ] Add health checks to Dockerfile
+- [ ] Document Docker usage in `docs/deployment.md`
+
+#### 7.8 Deployment Guides
+- [ ] Create `docs/deployment/kubernetes.md`:
+  - Kubernetes manifests
+  - Helm chart (optional)
+  - Service definitions
+  - ConfigMap and Secret management
+- [ ] Create `docs/deployment/docker.md`:
+  - Docker Compose deployment
+  - Environment variables
+  - Volume mounts
+- [ ] Create `docs/deployment/cloud.md`:
+  - AWS/GCP/Azure deployment notes
+  - Managed service integration
+  - Load balancer configuration
+
+#### 7.9 Developer Experience
+- [ ] Create `Makefile` with common tasks:
+  ```makefile
+  make dev          # Start dev environment
+  make test         # Run tests
+  make lint         # Run linters
+  make generate     # Generate code
+  make docker-build # Build Docker image
+  make migrate      # Run migrations
+  ```
+- [ ] Add development scripts:
+  - `scripts/dev.sh` - Start all services
+  - `scripts/test.sh` - Run test suite
+  - `scripts/seed.sh` - Seed test data
+- [ ] Create `.env.example` with all config variables
+- [ ] Add pre-commit hooks (optional):
+  - Run linter
+  - Run tests
+  - Check formatting
+
+### Deliverables
+- ✅ >80% test coverage
+- ✅ Integration test suite
+- ✅ Complete documentation
+- ✅ Production CI/CD pipeline
+- ✅ Docker images and deployment guides
+- ✅ Developer tooling and scripts
+
+### Acceptance Criteria
+- All tests pass in CI
+- Code coverage >80%
+- Documentation is complete and accurate
+- Docker images build and run successfully
+- Deployment guides are tested
+- New developers can set up environment in <30 minutes
+
+---
+
+## Phase 8: Advanced Features & Polish (Week 9-10, Optional)
+
+### Objectives
+- Add advanced features (OIDC, GraphQL, API Gateway)
+- Performance optimization
+- Additional sample modules
+- Final polish and bug fixes
+
+### Tasks
+
+#### 8.1 OpenID Connect (OIDC) Support
+- [ ] Install `github.com/coreos/go-oidc`
+- [ ] Implement OIDC provider:
+  - Discovery endpoint
+  - JWKS endpoint
+  - Token endpoint
+  - UserInfo endpoint
+- [ ] Add OIDC client support:
+  - Validate tokens from external IdP
+  - Map claims to internal user
+- [ ] Document OIDC setup in `docs/auth.md`
+
+#### 8.2 GraphQL API (Optional)
+- [ ] Install `github.com/99designs/gqlgen`
+- [ ] Create GraphQL schema:
+  - User queries
+  - Blog queries
+  - Mutations
+- [ ] Implement resolvers:
+  - Use existing services
+  - Add authorization checks
+- [ ] Add GraphQL endpoint: `POST /graphql`
+
+#### 8.3 API Gateway Features
+- [ ] Add request/response transformation
+- [ ] Add API key authentication
+- [ ] Add request routing rules
+- [ ] Add API versioning support
+
+#### 8.4 Additional Sample Modules
+- [ ] Create `modules/notification/`:
+  - Email templates
+  - Notification preferences
+  - Notification history
+- [ ] Create `modules/analytics/`:
+  - Event tracking
+  - Analytics dashboard API
+  - Export functionality
+
+#### 8.5 Performance Optimization
+- [ ] Add database query caching
+- [ ] Optimize N+1 queries
+- [ ] Add response caching (Redis)
+- [ ] Implement connection pooling optimizations
+- [ ] Add database read replicas support
+
+#### 8.6 Internationalization (i18n)
+- [ ] Install i18n library
+- [ ] Add locale detection:
+  - From Accept-Language header
+  - From user preferences
+- [ ] Create message catalogs
+- [ ] Add translation support for error messages
+
+#### 8.7 Final Polish
+- [ ] Code review and refactoring
+- [ ] Bug fixes
+- [ ] Performance profiling
+- [ ] Security audit
+- [ ] Documentation review
+
+### Deliverables
+- ✅ OIDC support (optional)
+- ✅ GraphQL API (optional)
+- ✅ Additional sample modules
+- ✅ Performance optimizations
+- ✅ Final polish
+
+---
+
+## Implementation Checklist Summary
+
+### Phase 0: Setup ✅
+- [ ] Repository structure
+- [ ] Configuration system
+- [ ] Logging foundation
+- [ ] Basic CI/CD
+- [ ] DI setup
+
+### Phase 1: Core Kernel ✅
+- [ ] DI container
+- [ ] Database (Ent)
+- [ ] Health & metrics
+- [ ] Error bus
+- [ ] HTTP server
+- [ ] OpenTelemetry
+
+### Phase 2: Auth & Authorization ✅
+- [ ] JWT authentication
+- [ ] Identity management
+- [ ] Roles & permissions
+- [ ] Authorization middleware
+- [ ] Audit logging
+
+### Phase 3: Module Framework ✅
+- [ ] Module interface
+- [ ] Static registry
+- [ ] Permission generation
+- [ ] Module loader
+- [ ] Module initialization
+
+### Phase 4: Sample Module (Blog) ✅
+- [ ] Blog module structure
+- [ ] Domain model
+- [ ] Repository & service
+- [ ] API handlers
+- [ ] Integration tests
+
+### Phase 5: Infrastructure ✅
+- [ ] Cache (Redis)
+- [ ] Event bus
+- [ ] Blob storage
+- [ ] Email notification
+- [ ] Scheduler/jobs
+- [ ] Multi-tenancy (optional)
+
+### Phase 6: Observability ✅
+- [ ] OpenTelemetry
+- [ ] Sentry integration
+- [ ] Enhanced logging
+- [ ] Prometheus metrics
+- [ ] Grafana dashboards
+- [ ] Rate limiting
+- [ ] Security hardening
+
+### Phase 7: Testing & Docs ✅
+- [ ] Unit tests (>80% coverage)
+- [ ] Integration tests
+- [ ] Documentation
+- [ ] CI/CD pipeline
+- [ ] Docker images
+- [ ] Deployment guides
+
+### Phase 8: Advanced Features (Optional) ✅
+- [ ] OIDC support
+- [ ] GraphQL API
+- [ ] Additional modules
+- [ ] Performance optimization
+
+---
+
+## Risk Mitigation
+
+### Technical Risks
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| **Circular import issues** | High | Strict separation: interfaces in `pkg/`, implementations in `internal/` |
+| **Plugin version mismatch** | Medium | Prefer static registration; document version requirements |
+| **Database migration conflicts** | Medium | Central migration orchestrator, dependency ordering |
+| **Performance bottlenecks** | Low | Load testing in Phase 7, profiling, caching strategy |
+| **Security vulnerabilities** | High | Security audit, gosec scanning, input validation |
+
+### Process Risks
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| **Scope creep** | Medium | Stick to phased approach, defer optional features to Phase 8 |
+| **Incomplete documentation** | Medium | Documentation as part of each phase, not afterthought |
+| **Testing gaps** | High | Test coverage requirements, integration tests early |
+
+---
+
+## Success Criteria
+
+The platform is considered complete when:
+
+1. ✅ All core modules are implemented and tested
+2. ✅ Blog module serves as working reference
+3. ✅ Test coverage >80%
+4. ✅ Documentation is complete
+5. ✅ CI/CD pipeline is production-ready
+6. ✅ Docker images build and run
+7. ✅ Integration tests pass
+8. ✅ Security audit passes
+9. ✅ Performance meets SLA (<100ms p95 for auth)
+10. ✅ New developer can set up in <30 minutes
+
+---
+
+## Next Steps After Implementation
+
+1. **Gather Feedback**: Share with team, collect requirements
+2. **Iterate**: Add features based on feedback
+3. **Scale**: Optimize for production load
+4. **Extend**: Add more modules as needed
+5. **Community**: Open source (if applicable), gather contributors
+
+---
+
+## References
+
+- [playbook.md](./playbook.md) - General platform playbook
+- [playbook-golang.md](./playbook-golang.md) - Go-specific playbook
+- [Go Modules Documentation](https://go.dev/doc/modules)
+- [Ent Documentation](https://entgo.io/docs/getting-started)
+- [Uber FX Documentation](https://github.com/uber-go/fx)
+- [OpenTelemetry Go](https://opentelemetry.io/docs/instrumentation/go/)
+
+---
+
+**Document Version:** 1.0  
+**Status:** Ready for Implementation
+
diff --git a/docs/playbook.md b/docs/playbook.md
new file mode 100644
index 0000000..801bcec
--- /dev/null
+++ b/docs/playbook.md
@@ -0,0 +1,620 @@
+# Go‑Platform Boilerplate Play‑book  
+**“Plug‑in‑friendly SaaS/Enterprise Platform – Go Edition”**  
+
+## 1️⃣ ARCHITECTURAL IMPERATIVES (Go‑flavoured)
+
+| Principle | Go‑specific rationale | Enforcement Technique |
+|-----------|-----------------------|------------------------|
+| **Clean / Hexagonal Architecture** | Go’s package‑level visibility (`internal/`) naturally creates a *boundary* between core and plug‑ins. | Keep all **domain** code in `internal/domain`, expose only **interfaces** in `pkg/`. |
+| **Dependency Injection (DI) via Constructors** | Go avoids reflection‑heavy containers; compile‑time wiring is preferred. | Use **uber‑go/fx** (runtime graph) *or* **uber‑go/dig** for optional runtime DI. For a lighter weight solution, use plain **constructor injection** with a small **registry**. |
+| **Modular Monolith → Micro‑service‑ready** | A single binary is cheap in Go; later you can extract modules into separate services without breaking APIs. | Each module lives in its own Go **module** (`go.mod`) under `./modules/*`. The core loads them via the **Go plugin** system *or* static registration (preferred for CI stability). |
+| **Plugin‑first design** | Go’s `plugin` package allows runtime loading of compiled `.so` files (Linux/macOS). | Provide an **IModule** interface and a **loader** that discovers `*.so` files (or compiled‑in modules for CI). |
+| **API‑First (OpenAPI + gin/gorilla)** | Guarantees language‑agnostic contracts. | Generate server stubs from an `openapi.yaml` stored in `api/`. |
+| **Security‑by‑Design** | Go’s static typing makes it easy to keep auth data out of the request flow. | Central middleware for JWT verification + context‑based user propagation. |
+| **Observability (OpenTelemetry)** | The Go ecosystem ships first‑class OTEL SDK. | Instrument HTTP, DB, queues, and custom events automatically. |
+| **Configuration‑as‑Code** | Viper + Cobra give hierarchical config and flag parsing. | Load defaults → file → env → secret manager (AWS Secrets Manager / Vault). |
+| **Testing & CI** | `go test` is fast; Testcontainers via **testcontainers-go** can spin up DB, Redis, Kafka. | CI pipeline runs unit, integration, and contract tests on each PR. |
+| **Semantic Versioning & Compatibility** | Go modules already enforce version constraints. | Core declares **minimal required versions** in `go.mod` and uses `replace` for local dev. |
+
+---
+
+## 2️⃣ CORE KERNEL (What every Go‑platform must ship)
+
+| Module | Public Interfaces (exported from `pkg/`) | Recommended Packages | Brief Implementation Sketch |
+|--------|-------------------------------------------|----------------------|------------------------------|
+| **Config** | `type ConfigProvider interface { Get(key string) any; Unmarshal(v any) error }` | `github.com/spf13/viper` | Load defaults (`config/default.yaml`), then env overrides, then optional secret‑store. |
+| **Logger** | `type Logger interface { Debug(msg string, fields ...Field); Info(...); Error(...); With(fields ...Field) Logger }` | `go.uber.org/zap` (or `zerolog`) | Global logger is created in `cmd/main.go`; exported via `pkg/logger`. |
+| **DI / Service Registry** | `type Container interface { Provide(constructor any) error; Invoke(fn any) error }` | `go.uber.org/dig` (or `fx` for lifecycle) | Core creates a `dig.New()` container, registers core services, then calls `container.Invoke(app.Start)`. |
+| **Health & Metrics** | `type HealthChecker interface { Check(ctx context.Context) error }` | `github.com/prometheus/client_golang/prometheus`, `github.com/heptiolabs/healthcheck` | Expose `/healthz`, `/ready`, `/metrics`. |
+| **Error Bus** | `type ErrorPublisher interface { Publish(err error) }` | Simple channel‐based implementation + optional Sentry (`github.com/getsentry/sentry-go`) | Core registers a singleton `ErrorBus`. |
+| **Auth (JWT + OIDC)** | `type Authenticator interface { GenerateToken(userID string, roles []string) (string, error); VerifyToken(token string) (*TokenClaims, error) }` | `github.com/golang-jwt/jwt/v5`, `github.com/coreos/go-oidc` | Token claims embed `sub`, `roles`, `tenant_id`. Middleware adds `User` to `context.Context`. |
+| **Authorization (RBAC/ABAC)** | `type Authorizer interface { Authorize(ctx context.Context, perm Permission) error }` | Custom DSL, `github.com/casbin/casbin/v2` (optional) | Permission format: `"module.resource.action"`; core ships a simple in‑memory resolver and a `casbin` adapter. |
+| **Audit** | `type Auditor interface { Record(ctx context.Context, act AuditAction) error }` | Write to append‑only table (Postgres) or Elastic via `olivere/elastic` | Audits include `actorID`, `action`, `targetID`, `metadata`. |
+| **Event Bus** | `type EventBus interface { Publish(ctx context.Context, ev Event) error; Subscribe(topic string, handler EventHandler) }` | `github.com/segmentio/kafka-go` (for production) + in‑process fallback | Core ships an **in‑process bus** used by tests and a **Kafka bus** for real deployments. |
+| **Persistence (Repository)** | `type UserRepo interface { FindByID(id string) (*User, error); Create(u *User) error; … }` | `entgo.io/ent` (code‑gen ORM) **or** `gorm.io/gorm` | Core provides an `EntClient` wrapper that implements all core repos. |
+| **Scheduler / Background Jobs** | `type Scheduler interface { Cron(spec string, job JobFunc) error; Enqueue(q string, payload any) error }` | `github.com/robfig/cron/v3`, `github.com/hibiken/asynq` (Redis‑backed) | Expose a `JobRegistry` where modules can register periodic jobs. |
+| **Notification** | `type Notifier interface { Send(ctx context.Context, n Notification) error }` | `github.com/go-mail/mail` (SMTP), `github.com/aws/aws-sdk-go-v2/service/ses`, `github.com/IBM/sarama` (for push) | Core supplies an `EmailNotifier` and a `WebhookNotifier`. |
+| **Multitenancy (optional)** | `type TenantResolver interface { Resolve(ctx context.Context) (tenantID string, err error) }` | Header/ sub‑domain parser + JWT claim scanner | Tenant ID is stored in request context and automatically added to SQL queries via Ent’s `Client` interceptor. |
+
+All *public* interfaces live under `pkg/` so that plug‑ins can import them without pulling in implementation details. The concrete implementations stay in `internal/` (or separate go.mod modules) and are **registered with the container** during bootstrap.
+
+---
+
+## 3️⃣ MODULE (PLUGIN) FRAMEWORK
+
+### 3.1 Interface that every module must implement
+
+```go
+// pkg/module/module.go
+package module
+
+import (
+    "context"
+    "go.uber.org/fx"
+)
+
+// IModule is the contract a feature plug‑in must fulfil.
+type IModule interface {
+    // Name returns a unique, human‑readable identifier.
+    Name() string
+    // Init registers the module's services, routes, jobs, and permissions.
+    // The fx.Options returned are merged into the app's lifecycle.
+    Init() fx.Option
+    // Migrations returns a slice of Ent migration functions (or raw SQL) that
+    // the core will run when the platform starts.
+    Migrations() []func(*ent.Client) error
+}
+```
+
+### 3.2 Registration Mechanics
+
+Two ways to get a module into the platform:
+
+| Approach | When to use | Pros | Cons |
+|----------|-------------|------|------|
+| **Static registration** – each module imports `core` and calls `module.Register(MyBlogModule{})` in its own `init()` | Development, CI (no `.so` needed) | Simpler, works on Windows; compile‑time type safety | Requires recompiling the binary for new modules |
+| **Runtime `plugin` loading** – compile each module as a `go build -buildmode=plugin -o blog.so ./modules/blog` | Production SaaS where clients drop new modules, or separate micro‑service extraction | Hot‑swap without rebuild | Only works on Linux/macOS; plugins must be compiled with same Go version & same `go.mod` replace graph; debugging harder |
+
+**Static registration example**
+
+```go
+// internal/registry/registry.go
+package registry
+
+import (
+    "sync"
+    "github.com/yourorg/platform/pkg/module"
+)
+
+var (
+    mu      sync.Mutex
+    modules = make(map[string]module.IModule)
+)
+
+func Register(m module.IModule) {
+    mu.Lock()
+    defer mu.Unlock()
+    if _, ok := modules[m.Name()]; ok {
+        panic("module already registered: " + m.Name())
+    }
+    modules[m.Name()] = m
+}
+
+func All() []module.IModule {
+    mu.Lock()
+    defer mu.Unlock()
+    out := make([]module.IModule, 0, len(modules))
+    for _, m := range modules {
+        out = append(out, m)
+    }
+    return out
+}
+```
+
+**Plugin loader skeleton**
+
+```go
+// internal/pluginloader/loader.go
+package pluginloader
+
+import (
+    "plugin"
+    "github.com/yourorg/platform/pkg/module"
+)
+
+func Load(path string) (module.IModule, error) {
+    p, err := plugin.Open(path)
+    if err != nil {
+        return nil, err
+    }
+    sym, err := p.Lookup("Module")
+    if err != nil {
+        return nil, err
+    }
+    mod, ok := sym.(module.IModule)
+    if !ok {
+        return nil, fmt.Errorf("invalid module type")
+    }
+    return mod, nil
+}
+```
+
+> **Tip:** Ship a tiny CLI (`platformctl modules list`) that scans `./plugins/*.so`, loads each via `Load`, and prints `Name()`. This is a great sanity check for ops.
+
+### 3.3 Permissions DSL (compile‑time safety)
+
+```go
+// pkg/perm/perm.go
+package perm
+
+type Permission string
+
+func (p Permission) String() string { return string(p) }
+
+var (
+    // Core permissions
+    SystemHealthCheck Permission = "system.health.check"
+
+    // Blog module – generated by a small go:generate script
+    BlogPostCreate Permission = "blog.post.create"
+    BlogPostRead   Permission = "blog.post.read"
+    BlogPostUpdate Permission = "blog.post.update"
+    BlogPostDelete Permission = "blog.post.delete"
+)
+```
+
+A **code‑gen** tool (`go generate ./...`) can scan each module’s `module.yaml` for declared actions and emit a single `perm.go` file, guaranteeing no duplicate strings.
+
+---
+
+## 4️⃣ SAMPLE FEATURE MODULE – **Blog**
+
+```
+modules/
+└─ blog/
+   ├─ go.mod               # (module github.com/yourorg/blog)
+   ├─ module.yaml
+   ├─ internal/
+   │   ├─ api/
+   │   │   └─ handler.go
+   │   ├─ domain/
+   │   │   ├─ post.go
+   │   │   └─ post_repo.go
+   │   └─ service/
+   │       └─ post_service.go
+   └─ pkg/
+       └─ module.go
+```
+
+### 4.1 `module.yaml`
+
+```yaml
+name: blog
+version: 0.1.0
+dependencies:
+  - core >= 1.3.0
+permissions:
+  - blog.post.create
+  - blog.post.read
+  - blog.post.update
+  - blog.post.delete
+routes:
+  - method: POST
+    path: /api/v1/blog/posts
+    permission: blog.post.create
+  - method: GET
+    path: /api/v1/blog/posts/:id
+    permission: blog.post.read
+```
+
+### 4.2 Go implementation
+
+```go
+// pkg/module.go
+package blog
+
+import (
+    "github.com/yourorg/platform/pkg/module"
+    "go.uber.org/fx"
+)
+
+type BlogModule struct{}
+
+func (b BlogModule) Name() string { return "blog" }
+
+func (b BlogModule) Init() fx.Option {
+    return fx.Options(
+        // Register repository implementation
+        fx.Provide(NewPostRepo),
+
+        // Register service layer
+        fx.Provide(NewPostService),
+
+        // Register HTTP handlers (using Gin)
+        fx.Invoke(RegisterHandlers),
+
+        // Register permissions (optional – just for documentation)
+        fx.Invoke(RegisterPermissions),
+    )
+}
+
+func (b BlogModule) Migrations() []func(*ent.Client) error {
+    // Ent migration generated in internal/ent/migrate
+    return []func(*ent.Client) error{
+        func(c *ent.Client) error { return c.Schema.Create(context.Background()) },
+    }
+}
+
+// Export a variable for the plugin loader
+var Module BlogModule
+```
+
+**Handler registration (Gin example)**
+
+```go
+// internal/api/handler.go
+package api
+
+import (
+    "github.com/gin-gonic/gin"
+    "github.com/yourorg/blog/internal/service"
+    "github.com/yourorg/platform/pkg/perm"
+    "github.com/yourorg/platform/pkg/auth"
+)
+
+func RegisterHandlers(r *gin.Engine, svc *service.PostService, authz auth.Authorizer) {
+    grp := r.Group("/api/v1/blog")
+    grp.Use(auth.AuthMiddleware()) // verifies JWT, injects user in context
+
+    // POST /posts
+    grp.POST("/posts", func(c *gin.Context) {
+        if err := authz.Authorize(c.Request.Context(), perm.BlogPostCreate); err != nil {
+            c.JSON(403, gin.H{"error": "forbidden"})
+            return
+        }
+        // decode request, call svc.Create, return 201…
+    })
+    // GET /posts/:id (similar)
+}
+```
+
+**Repository using Ent**
+
+```go
+// internal/domain/post_repo.go
+package domain
+
+import (
+    "context"
+    "github.com/yourorg/platform/internal/ent"
+    "github.com/yourorg/platform/internal/ent/post"
+)
+
+type PostRepo struct{ client *ent.Client }
+
+func NewPostRepo(client *ent.Client) *PostRepo { return &PostRepo{client} }
+
+func (r *PostRepo) Create(ctx context.Context, p *Post) (*Post, error) {
+    entPost, err := r.client.Post.
+        Create().
+        SetTitle(p.Title).
+        SetContent(p.Content).
+        SetAuthorID(p.AuthorID).
+        Save(ctx)
+    if err != nil {
+        return nil, err
+    }
+    return fromEnt(entPost), nil
+}
+```
+
+> **Result:** Adding a new feature is just a matter of creating a new folder under `modules/`, implementing `module.IModule`, registering routes, permissions and migrations. The core automatically wires everything together.
+
+---
+
+## 5️⃣ INFRASTRUCTURE ADAPTERS (swap‑able, per‑environment)
+
+| Concern | Implementation (Go) | Where it lives |
+|---------|---------------------|----------------|
+| **Database** | `entgo.io/ent` (code‑gen) | `internal/infra/ent/` |
+| **Cache** | `github.com/go-redis/redis/v9` | `internal/infra/cache/` |
+| **Message Queue** | `github.com/segmentio/kafka-go` (Kafka) **or** `github.com/hibiken/asynq` (Redis) | `internal/infra/bus/` |
+| **Blob Storage** | `github.com/aws/aws-sdk-go-v2/service/s3` (or GCS) | `internal/infra/blob/` |
+| **Email** | `github.com/go-mail/mail` (SMTP) | `internal/infra/email/` |
+| **SMS / Push** | Twilio SDK, Firebase Cloud Messaging | `internal/infra/notify/` |
+| **Secret Store** | AWS Secrets Manager (`aws-sdk-go-v2`) or HashiCorp Vault (`github.com/hashicorp/vault/api`) | `internal/infra/secret/` |
+
+All adapters expose an **interface** in `pkg/infra/…` and are registered in the DI container as **singletons**.
+
+---
+
+## 6️⃣ OBSERVABILITY STACK
+
+| Layer | Library | What it does |
+|-------|---------|--------------|
+| **Tracing** | `go.opentelemetry.io/otel`, `go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp` | Auto‑instrument HTTP, DB (Ent plugin), Kafka, Redis |
+| **Metrics** | `github.com/prometheus/client_golang/prometheus` | Counter/Histogram per request, DB latency, job execution |
+| **Logging** | `go.uber.org/zap` (structured JSON) | Global logger, request‑scoped fields (`request_id`, `user_id`, `tenant_id`) |
+| **Error Reporting** | `github.com/getsentry/sentry-go` (optional) | Capture panics & errors, link to trace ID |
+| **Dashboard** | Grafana + Prometheus + Loki (logs) | Provide ready‑made dashboards in `ops/` folder |
+
+**Instrumentation example (HTTP)**
+
+```go
+import (
+    "net/http"
+    "go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp"
+)
+
+func main() {
+    r := gin.New()
+    // Wrap the entire router with OTEL middleware
+    wrapped := otelhttp.NewHandler(r, "http-server")
+    http.ListenAndServe(":8080", wrapped)
+}
+```
+
+**Metrics middleware**
+
+```go
+func PromMetrics() gin.HandlerFunc {
+    return func(c *gin.Context) {
+        start := time.Now()
+        c.Next()
+        duration := time.Since(start).Seconds()
+        method := c.Request.Method
+        path := c.FullPath()
+        status := fmt.Sprintf("%d", c.Writer.Status())
+        requestDuration.WithLabelValues(method, path, status).Observe(duration)
+    }
+}
+```
+
+---
+
+## 7️⃣ CONFIGURATION & ENVIRONMENT
+
+```
+config/
+├─ default.yaml          # baseline values
+├─ development.yaml
+├─ production.yaml
+└─ secrets/              # git‑ignored, loaded via secret manager
+```
+
+**Bootstrap**
+
+```go
+func LoadConfig() (*Config, error) {
+    v := viper.New()
+    v.SetConfigName("default")
+    v.AddConfigPath("./config")
+    if err := v.ReadInConfig(); err != nil { return nil, err }
+
+    env := v.GetString("environment") // dev / prod / test
+    v.SetConfigName(env)
+    v.MergeInConfig() // overrides defaults
+
+    v.AutomaticEnv() // env vars win
+    // optional: secret manager overlay
+    return &Config{v}, nil
+}
+```
+
+All services receive a `*Config` via DI.
+
+---
+
+## 8️⃣ CI / CD PIPELINE (GitHub Actions)
+
+```yaml
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      GO111MODULE: on
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+      - name: Cache Go modules
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/go-build
+            ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
+      - name: Install Tools
+        run: |
+          go install github.com/vektra/mockery/v2@latest
+          go install github.com/golang/mock/mockgen@latest
+      - name: Lint
+        run: |
+          go install golang.org/x/lint/golint@latest
+          golint ./...
+      - name: Unit Tests
+        run: |
+          go test ./... -cover -race -short
+      - name: Integration Tests (Docker Compose)
+        run: |
+          docker compose -f ./docker-compose.test.yml up -d
+          go test ./... -tags=integration -count=1
+          docker compose -f ./docker-compose.test.yml down
+      - name: Build Binaries
+        run: |
+          go build -ldflags="-X main.version=${{ github.sha }}" -o bin/platform ./cmd/platform
+      - name: Publish Docker Image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: ${{ github.ref == 'refs/heads/main' }}
+          tags: ghcr.io/yourorg/platform:${{ github.sha }}
+```
+
+**Key points**
+
+* `go test ./... -tags=integration` runs tests that spin up Postgres, Redis, Kafka via **Testcontainers** (`github.com/testcontainers/testcontainers-go`).
+* Linting via `golint` or `staticcheck`.
+* Docker image built from the compiled binary (multi‑stage: `golang:1.22-alpine` → `scratch` or `distroless`).
+* Semantic‑release can be added on top (`semantic-release` action) to tag releases automatically.
+
+---
+
+## 9️⃣ TESTING STRATEGY
+
+| Test type | Tools | Typical coverage |
+|-----------|-------|------------------|
+| **Unit** | `testing`, `github.com/stretchr/testify`, `github.com/golang/mock` | Individual services, repositories (use in‑memory DB or mocks). |
+| **Integration** | `testcontainers-go` for Postgres, Redis, Kafka; real Ent client | End‑to‑end request → DB → event bus flow. |
+| **Contract** | `pact-go` or **OpenAPI** validator middleware (`github.com/getkin/kin-openapi`) | Guarantees that modules do not break the published API. |
+| **Load / Stress** | `k6` or `vegeta` scripts in `perf/` | Verify that auth middleware adds < 2 ms latency per request. |
+| **Security** | `gosec`, `zap` for secret detection, OWASP ZAP for API scan | Detect hard‑coded secrets, SQL injection risk. |
+
+**Example integration test skeleton**
+
+```go
+func TestCreatePost_Integration(t *testing.T) {
+    ctx := context.Background()
+    // Spin up a PostgreSQL container
+    pg, err := testcontainers.GenericContainer(ctx, testcontainers.GenericContainerRequest{
+        ContainerRequest: testcontainers.ContainerRequest{
+            Image:        "postgres:15-alpine",
+            Env:          map[string]string{"POSTGRES_PASSWORD": "secret", "POSTGRES_DB": "test"},
+            ExposedPorts: []string{"5432/tcp"},
+            WaitingFor:   wait.ForListeningPort("5432/tcp"),
+        },
+        Started: true,
+    })
+    require.NoError(t, err)
+    defer pg.Terminate(ctx)
+
+    // Build DSN from container host/port
+    host, _ := pg.Endpoint(ctx)
+    dsn := fmt.Sprintf("postgres://postgres:secret@%s/test?sslmode=disable", host)
+
+    // Initialize Ent client against that DSN
+    client, err := ent.Open("postgres", dsn)
+    require.NoError(t, err)
+    defer client.Close()
+    // Run schema migration
+    err = client.Schema.Create(ctx)
+    require.NoError(t, err)
+
+    // Build the whole app using fx, injecting the test client
+    app := fx.New(
+        core.ProvideAll(),
+        fx.Provide(func() *ent.Client { return client }),
+        blog.Module.Init(),
+        // ...
+    )
+    // Start the app, issue a HTTP POST request through httptest.Server,
+    // assert 201 and DB row existence.
+}
+```
+
+---
+
+## 10️⃣ COMMON PITFALLS & SOLUTIONS (Go‑centric)
+
+| Pitfall | Symptom | Remedy |
+|---------|----------|--------|
+| **Circular imports** (core ↔ module) | `import cycle not allowed` build error | Keep **interfaces only** in `pkg/`. Core implements, modules depend on the interface only. |
+| **Too‑big binary** (all modules compiled in) | Long build times, memory pressure on CI | Use **Go plugins** for truly optional modules; keep core binary minimal. |
+| **Version mismatch with plugins** | Panic: `plugin was built with a different version of package X` | Enforce a **single `replace` directive** for core in each module’s `go.mod` (e.g., `replace github.com/yourorg/platform => ../../platform`). |
+| **Context leakage** (request data not passed) | Logs missing `user_id`, permission checks use zero‑value user | Always store user/tenant info in `context.Context` via middleware; provide helper `auth.FromContext(ctx)`. |
+| **Ent migrations out‑of‑sync** | Startup fails with “column does not exist” | Run `go generate ./...` (ent codegen) and `ent/migrate` automatically at boot **after all module migrations are collected**. |
+| **Hard‑coded permission strings** | Typos go unnoticed → 403 bugs | Use the **generated `perm` package** (see §4.1) and reference constants everywhere. |
+| **Blocking I/O in request path** | 500 ms latency spikes | Off‑load long‑running work to **asynq jobs** or **Kafka consumers**; keep request handlers thin. |
+| **Over‑exposed HTTP handlers** | Missing auth middleware → open endpoint | Wrap the router with a **global security middleware** that checks a whitelist and enforces `Authorizer` for everything else. |
+| **Memory leaks with goroutine workers** | Leak after many module reloads | Use **fx.Lifecycle** to start/stop background workers; always cancel contexts on `Stop`. |
+| **Testing with real DB slows CI** | Pipeline > 10 min | Use **testcontainers** in parallel jobs, cache Docker images, or use in‑memory SQLite for unit tests and only run DB‑heavy tests in a dedicated job. |
+
+---
+
+## 11️⃣ QUICK‑START STEPS (What to code first)
+
+1. **Bootstrap repo**  
+   ```bash
+   mkdir platform && cd platform
+   go mod init github.com/yourorg/platform
+   mkdir cmd internal pkg config modules
+   touch cmd/main.go
+   ```
+2. **Create core container** (`internal/di/container.go`) using `dig`. Register Config, Logger, DB, EventBus, Authenticator, Authorizer.
+3. **Add Auth middleware** (`pkg/auth/middleware.go`) that extracts JWT, validates claims, injects `User` into context.
+4. **Implement Permission DSL** (`pkg/perm/perm.go`) and a **simple in‑memory resolver** (`pkg/perm/resolver.go`).
+5. **Write `module` interface** (`pkg/module/module.go`) and a **static registry** (`internal/registry/registry.go`).
+6. **Add first plug‑in** – copy the **Blog** module skeleton from §4.  
+   `cd modules/blog && go mod init github.com/yourorg/blog && go run ../..` (build & test).
+7. **Wire everything in `cmd/main.go`** using `fx.New(...)`:
+   ```go
+   app := fx.New(
+       core.Module,               // registers core services
+       fx.Invoke(registry.RegisterAllModules), // loads static modules
+       fx.Invoke(func(lc fx.Lifecycle, r *gin.Engine) {
+           lc.Append(fx.Hook{
+               OnStart: func(context.Context) error {
+                   go r.Run(":8080")
+                   return nil
+               },
+               OnStop: func(ctx context.Context) error { return nil },
+           })
+       }),
+   )
+   app.Run()
+   ```
+8. **Run integration test** (`go test ./... -tags=integration`) to sanity‑check DB + routes.
+9. **Add CI workflow** (copy the `.github/workflows/ci.yml` from §8) and push.
+10. **Publish first Docker image** (`docker build -t ghcr.io/yourorg/platform:dev .`).
+
+After step 10 you have a **complete, production‑grade scaffolding** that:
+
+* authenticates users via JWT (with optional OIDC),
+* authorizes actions through a compile‑time‑checked permission DSL,
+* logs/metrics/traces out of the box,
+* lets any team drop a new `*.so` or static module under `modules/` to add resources,
+* ships with a working CI pipeline and a ready‑to‑run Docker image.
+
+---
+
+## 12️⃣ REFERENCE IMPLEMENTATION (public)
+
+If you prefer to start from a **real open‑source baseline**, check out the following community projects that already adopt most of the ideas above:
+
+| Repo | Highlights |
+|------|------------|
+| `github.com/go‑microservices/clean‑arch` | Clean‑architecture skeleton, fx DI, Ent ORM, JWT auth |
+| `github.com/ory/hydra` | Full OIDC provider (good for auth reference) |
+| `github.com/segmentio/kafka-go` examples | Event‑bus integration |
+| `github.com/ThreeDotsLabs/watermill` | Pub/sub abstraction usable as bus wrapper |
+| `github.com/hibiken/asynq` | Background job framework (Redis based) |
+
+Fork one, strip the business logic, and rename the packages to match *your* `github.com/yourorg/platform` namespace.
+
+---
+
+## 13️⃣ FINAL CHECKLIST (before you ship)
+
+- [ ] Core modules compiled & registered in `internal/di`.  
+- [ ] `module.IModule` interface and static registry in place.  
+- [ ] JWT auth + middleware + `User` context helper.  
+- [ ] Permission constants generated & compiled in `pkg/perm`.  
+- [ ] Ent schema + migration runner that aggregates all module migrations.  
+- [ ] OpenTelemetry tracer/provider wired at process start.  
+- [ ] Prometheus metrics endpoint (`/metrics`).  
+- [ ] Health endpoints (`/healthz`, `/ready`).  
+- [ ] Dockerfile (multi‑stage) and `docker-compose.yml` for dev.  
+- [ ] GitHub Actions pipeline (CI) passes all tests.  
+- [ ] Sample plug‑in (Blog) builds, loads, registers routes, and passes integration test.  
+- [ ] Documentation: `README.md`, `docs/architecture.md`, `docs/extension-points.md`.  
+
+> **Congratulations!** You now have a **robust, extensible Go platform boilerplate** that can be the foundation for any SaaS, internal toolset, or micro‑service ecosystem you wish to build. Happy coding! 🚀
\ No newline at end of file
diff --git a/docs/requirements.md b/docs/requirements.md
new file mode 100644
index 0000000..0c5da65
--- /dev/null
+++ b/docs/requirements.md
@@ -0,0 +1,319 @@
+# Requirements
+
+## 1️⃣ HIGH‑LEVEL ARCHITECTURAL PRINCIPLES
+
+| Principle | Why it matters for a modular platform | How to enforce it |
+|-----------|----------------------------------------|-------------------|
+| **Separation of Concerns (SoC)** | Keeps core services (auth, audit, config) independent from business modules. | Use **layered** or **hexagonal/clean‑architecture** boundaries. |
+| **Domain‑Driven Design (DDD) Bounded Contexts** | Allows each module to own its own model & rules while sharing a common identity kernel. | Define a **Core Context** (Identity, Security, Infrastructure) and **Feature Contexts** (Billing, CMS, Chat, …). |
+| **Modular Monolith → Micro‑service‑ready** | Start simple (single process) but keep each module in its own package so you can later split to services if needed. | Package each module as an **independent library** with its own **DI container‑module** and **routing**. |
+| **Plug‑in / Extension‑point model** | Enables customers or internal teams to drop new features without touching core code. | Export **well‑defined interfaces** (e.g., `IUserProvider`, `IPermissionResolver`, `IModuleInitializer`). |
+| **API‑First** | Guarantees that any UI (web, mobile, CLI) can be built on top of the same contract. | Publish **OpenAPI/GraphQL schema** as part of the build artefact. |
+| **Security‑by‑Design** | The platform will hold user credentials, roles and possibly PII. | Centralize **authentication**, **authorization**, **audit**, **rate‑limiting**, **CORS**, **CSP**, **secure defaults**. |
+| **Observability** | You need to know when a plug‑in crashes or misbehaves. | Provide **structured logging**, **metrics**, **tracing**, **health‑checks**, **central error bus**. |
+| **CI/CD‑Ready Boilerplate** | Keeps the framework maintainable and encourages best‑practice adoption. | Include **GitHub Actions / GitLab CI** pipelines that run lint, unit, integration, contract tests, and a publish step. |
+| **Configuration‑as‑Code** | Each module may need its own settings but you want a single source of truth. | Use a **hierarchical config system** (environment > file > secret store). |
+| **Multitenancy (optional)** | If you plan SaaS, the core must be ready to isolate data per tenant. | Provide **tenant‑aware repository abstractions** and **tenant‑scoped middlewares**. |
+| **Versioning & Compatibility** | Modules evolve; the core should never break existing plug‑ins. | Adopt **semantic versioning** + **backwards‑compatibility shim layer** (e.g., deprecation warnings). |
+
+---
+
+## 2️⃣ LAYERED / HEXAGONAL BLUEPRINT
+
+```
++---------------------------------------------------+
+|                     Presentation                  |
+| (REST/GraphQL/ gRPC Controllers, UI SDKs, CLI)    |
++-------------------+-------------------------------+
+|        Application Services (Use‑cases)          |
+|  - orchestrate core & feature modules            |
+|  - enforce policies (RBAC, rate‑limit)           |
++-------------------+-------------------------------+
+|            Domain (Business Logic)               |
+|  - Core Entities (User, Role, Permission)       |
+|  - Domain Services (PasswordPolicy, TokenMgr)   |
++-------------------+-------------------------------+
+|           Infrastructure / Adapters              |
+|  - Persistence (ORM/NoSQL Repositories)         |
+|  - External services (Email, SMS, OIDC)         |
+|  - Event bus (Kafka/Rabbit, In‑process)         |
+|  - File storage, Cache, Search                  |
++---------------------------------------------------+
+|                Platform Core (Kernel)            |
+|  - DI container, Module loader, Config manager   |
+|  - Cross‑cutting concerns (Logging, Metrics)    |
+|  - Security subsystem (AuthN/AuthZ, Token Issuer)|
++---------------------------------------------------+
+```
+
+*All layers talk to each other **through interfaces** defined in the Core kernel.  Feature modules implement those interfaces and register themselves at startup.*
+
+---
+
+## 3️⃣ REQUIRED BASE MODULES (THE “CORE KERNEL”)
+
+| Module | Core responsibilities | Public API / Extension points |
+|--------|-----------------------|--------------------------------|
+| **Identity‑Management** | - User CRUD (local + federation) <br>- Password hashing, reset flow <br>- Email/Phone verification | `IUserRepository`, `IUserService`, `IExternalIdpProvider` |
+| **Roles & Permissions** | - Role hierarchy (role → permission set) <br>- Permission definitions (string, enum, policy) <br>- Dynamic permission evaluation (ABAC) | `IPermissionResolver`, `IRoleService` |
+| **Authentication** | - JWT / OAuth2 Access & Refresh tokens <br>- OpenID Connect Provider (optional) <br>- Session Management (stateless + optional stateful) | `IAuthService`, `ITokenProvider` |
+| **Authorization Middleware** | - Enforce RBAC/ABAC on each request <br>- Policy DSL (e.g., `hasPermission('project.read') && resource.ownerId == user.id`) | `IAuthorizationHandler` |
+| **Audit & Activity Log** | - Immutable log of security‑relevant actions <br>- Correlation IDs, actor, target, timestamp | `IAuditSink`, `IAuditService` |
+| **Configuration** | - Hierarchical sources (env, files, secret manager) <br>- Validation schema (JSON‑Schema / Yup / JSR‑380) | `IConfigProvider` |
+| **Health & Metrics** | - `/healthz`, `/ready`, `/metrics` endpoints <br>- Export to Prometheus, Grafana, CloudWatch | `IHealthCheck`, `IMetricsRegistry` |
+| **Error Handling** | - Centralized error objects, stack trace masking <br>- Automatic mapping to HTTP status <br>- Exception‑to‑event publishing | `IErrorMapper`, `IErrorBus` |
+| **Logging** | - Structured JSON logs (level, requestId, userId) <br>- pluggable sinks (stdout, file, ELK, Cloud Logging) | `ILoggerFactory` |
+| **Notification** | - Email, SMS, Push (FCM/APNs), Webhooks <br>- Queue‑backed delivery, retries | `INotificationService` |
+| **File / Blob Storage** | - Abstracted bucket API (upload, version, signed URLs) | `IBlobStore` |
+| **Scheduler / Background Jobs** | - Cron‑like tasks, queue workers, retry/back‑off policies | `IJobScheduler`, `IJobProcessor` |
+| **Internationalization (i18n)** | - Message catalog, locale negotiation, runtime translation | `I18nService` |
+| **API Gateway (optional)** | - Rate‑limit, request/response transformation, API‑key handling, request routing to modules | `IGatewayPlugin` |
+| **Multitenancy (optional)** | - Tenant identification (sub‑domain, header, JWT claim) <br>- Tenant‑scoped data isolation primitives | `ITenantResolver`, `ITenantContext` |
+
+> **Tip:** Pack each module as a **separate NPM/ Maven / NuGet / Go module** with its own `package.json` / `pom.xml` etc. The platform’s **bootstrapper** loads every module that implements `IModuleInitializer` (or similar) and calls `ConfigureServices` / `RegisterRoutes`.
+
+---
+
+## 4️⃣ EXTENSION‑POINT DESIGN (HOW PLUG‑INS HOOK IN)
+
+1. **Module Manifest** – a tiny JSON/YAML file (`module.yaml`) that declares:
+   - Module name, version, dependencies (core ≥ 1.2.0, other modules)
+   - Public routes (e.g., `/api/v1/blog/**`)
+   - Required permissions (auto‑generated from source annotations)
+   - UI assets (static folder, React component entry point)
+
+2. **Bootstrap Interface**
+   ```ts
+   export interface IModuleInitializer {
+       /**
+        * Called during platform start‑up.
+        * Register services, routes, policies, background jobs.
+        */
+       init(app: IApplicationBuilder, container: IServiceContainer): Promise<void>;
+   }
+   ```
+
+3. **Dependency Injection (DI) Conventions**
+   - Core registers **contracts** (`IUserRepository`, `IPermissionResolver`) as **singletons**.
+   - Modules register **implementations** with a **named scope** (e.g., `UserRepository:Local`).
+   - Override is possible via **module ordering** or explicit `container.override(...)`.
+
+4. **Policy/Permission Extension**
+   ```ts
+   // core lib
+   export type Permission = `${string}.${string}`; // e.g., "blog.post.create"
+
+   // module
+   export const BLOG_PERMS = {
+       POST_CREATE: 'blog.post.create',
+       POST_READ:   'blog.post.read',
+       POST_UPDATE: 'blog.post.update',
+       POST_DELETE: 'blog.post.delete',
+   } as const;
+   ```
+
+5. **Event Bus & Hooks**
+   - Central **topic**: `platform.*` (user.created, role.assigned, tenant.created)
+   - Modules can **publish** and **subscribe** via `IEventBus`.
+   - Provide **synchronous guard hooks** (`beforeUserCreate`, `afterRoleDelete`) for validation & side‑effects.
+
+6. **UI Plug‑in System**
+   - Serve a **manifest** at `/modules` that front‑end bundles read to render navigation.
+   - Encourage **Web Component / Module Federation** pattern for SPA integration.
+
+---
+
+## 5️⃣ SAMPLE REPOSITORY LAYOUT (language‑agnostic)
+
+```
+/platform-root
+│
+├─ /core                                   # ---- Kernel / Base modules ----
+│   ├─ /auth
+│   │   ├─ src/
+│   │   └─ package.json
+│   ├─ /identity
+│   ├─ /authorization
+│   ├─ /audit
+│   ├─ /config
+│   ├─ /logging
+│   ├─ /metrics
+│   └─ index.ts (exports all core APIs)
+│
+├─ /modules                                # ---- Feature plug‑ins ----
+│   ├─ /blog
+│   │   ├─ module.yaml                     # manifest
+│   │   ├─ src/
+│   │   │   ├─ BlogController.ts
+│   │   │   ├─ BlogService.ts
+│   │   │   └─ BlogModule.ts (implements IModuleInitializer)
+│   │   └─ package.json
+│   │
+│   ├─ /billing
+│   └─ /chat
+│
+├─ /infra                                   # ---- Infrastructure adapters ----
+│   ├─ /orm (typeorm/hibernate/EFCore etc.)
+│   ├─ /cache (redis)
+│   ├─ /queue (rabbit/kafka)
+│   └─ /storage (s3/azure‑blob)
+│
+├─ /gateway (optional API‑gateway layer)
+│
+├─ /scripts                                 # build / lint / test helpers
+│
+├─ /ci
+│   └─ github-actions.yml
+│
+├─ /docs
+│   └─ architecture.md
+│
+├─ package.json (or pom.xml / go.mod)
+└─ README.md
+```
+
+### How it boots
+
+```ts
+// platform-root/src/main.ts
+import { createApp } from '@core/app';
+import { loadModules } from '@core/module-loader';
+import { CoreModule } from '@core';
+
+async function bootstrap() {
+  const app = await createApp();
+
+  // 1️⃣ Load core kernel (DI, config, logger)
+  await app.register(CoreModule);
+
+  // 2️⃣ Dynamically discover all `module.yaml` under /modules
+  const modules = await loadModules(__dirname + '/modules');
+
+  // 3️⃣ Initialise each module (order can be defined in manifest)
+  for (const mod of modules) {
+    await mod.instance.init(app.builder, app.container);
+  }
+
+  // 4️⃣ Start HTTP / gRPC server
+  await app.listen(process.env.PORT || 3000);
+}
+
+bootstrap().catch(err => {
+  console.error('❌ Platform failed to start', err);
+  process.exit(1);
+});
+```
+
+---
+
+## 6️⃣ KEY DECISIONS YOU MUST TAKE EARLY
+
+| Decision | Options | Implications |
+|----------|---------|--------------|
+| **Language / Runtime** | Node.js (NestJS, Fastify), Java (Spring Boot), .NET (ASP.NET Core), Go (Gin/Fiber), Python (FastAPI) | Affects DI framework, module packaging, community libs for auth/OIDC, testing. |
+| **Persistence Strategy** | Relational (PostgreSQL, MySQL) + optional NoSQL (Mongo, Dynamo) | Choose an ORM/Repository pattern that can be swapped per module. |
+| **Auth Protocol** | JWT + Refresh, OAuth2 Authorization Server, OpenID Connect Provider, or integrate with external IdP (Keycloak, Auth0) | Influences token lifetimes, revocation strategy, multi‑tenant support. |
+| **Event Bus** | In‑process EventEmitter (for monolith) → Kafka/Rabbit for scaling | Must expose both sync and async hooks. |
+| **Module Packaging** | NPM packages (private registry) / Maven artifacts / Docker images (for micro‑service extraction) | Define a *semantic version* policy (core ≥ 1.0.0 never forces breaking changes on plug‑ins). |
+| **Multitenancy Model** | Single DB with tenant_id column (shared), Schema‑per‑tenant, or DB‑per‑tenant | Affects repository base class and migrations tooling. |
+| **Internationalisation** | i18next (frontend) + ICU messages in backend, or .NET Resource files | Choose a format that can be merged from modules at build time. |
+| **CI/CD** | GitHub Actions + Docker Buildx + semantic‑release | Automate publishing of core + modules to same artifact registry. |
+| **Testing Strategy** | Unit (Jest, JUnit, xUnit), Integration (Testcontainers), Contract (Pact) | Provide a **core testing harness** that loads a dummy module and asserts the contract of each extension point. |
+
+---
+
+## 7️⃣ COMMON PITFALLS & HOW TO AVOID THEM
+
+| Pitfall | Symptoms | Fix / Guardrail |
+|---------|----------|-----------------|
+| **Tight coupling of modules to core implementation** | Module imports internal ORM classes, fails on core upgrade. | Expose **only interfaces** (`IUserRepository`) from core and keep the concrete implementation as a private package. |
+| **Hard‑coded permission strings** | Duplicate names across modules, typos cause silent authorisation bypass. | Provide a **Permission Builder DSL** (`Permission.define('blog.post', ['create', 'read'])`) that generates constants and registers them automatically. |
+| **Global state in modules** | Tests interfere with each other, memory leaks when hot‑reloading. | Enforce **stateless services**; keep per‑request scoped data (e.g., via DI context). |
+| **Schema migrations clash** | Two modules try to add the same column or foreign key. | Adopt a **central migration orchestrator** (e.g., Flyway/DBMate) that loads migration scripts from each module in alphabetical order. |
+| **Authorization checks omitted in new routes** | Security hole for new plug‑in routes. | Provide a **base controller class** that auto‑applies `Authorize` filter, or a compile‑time lint rule that checks every exported route for a permission annotation. |
+| **Vendor lock‑in to a particular IdP** | Hard to replace Keycloak later. | Keep **IdP adapters** behind a `IIdentityProvider` interface; ship at least two (local DB + OIDC). |
+| **Unbounded background jobs** | Queue overflow, OOM, duplicate processing. | Use a **job‑scheduler abstraction** that caps concurrency, persists state, and provides `@Retry` decorator. |
+| **Insufficient observability** | You can’t tell which module caused latency spikes. | Tag every log/metric with `module=<moduleName>` automatically via middleware. |
+| **Version drift between core and modules** | Module built against core 1.0 fails on core 1.5. | Publish a **core compatibility matrix** and enforce `peerDependencies` in package.json; CI should fail on mismatched ranges. |
+
+---
+
+## 8️⃣ QUICK START GUIDE (What to Build First)
+
+1. **Create the Core Kernel**  
+   - Set up DI container, config loader, logger, health/metrics endpoint.  
+   - Scaffold `IUserRepository`, `IPermissionResolver`, `ITokenProvider`.  
+
+2. **Implement Identity & Auth**  
+   - Choose JWT + Refresh + optional OpenID Connect.  
+   - Add password hashing (bcrypt/argon2) and email verification flow.  
+
+3. **Add Role/Permission Engine**  
+   - Simple RBAC matrix with an extensible `Permission` type.  
+   - Provide a UI admin UI (or API only) to manage roles.  
+
+4. **Set Up Event Bus & Audit**  
+   - Publish `user.created`, `role.granted` events.  
+   - Store audit entries in an append‑only table (or log to Elastic).  
+
+5. **Build the Module Loader**  
+   - Scan `modules/*/module.yaml`, load via `require()`/classpath.  
+   - Register each `IModuleInitializer`.  
+
+6. **Create a Sample Feature Module** – e.g., **Blog**  
+   - Define its own entities (`Post`, `Comment`).  
+   - Register routes (`/api/v1/blog/posts`).  
+   - Declare required permissions (`blog.post.create`).  
+
+7. **Write Integration Tests**  
+   - Spin up an in‑memory DB (SQLite or H2).  
+   - Load core + blog module, assert that a user without `blog.post.create` receives 403.  
+
+8. **Add CI Pipeline**  
+   - Lint → Unit → Integration (Docker Compose with DB + Redis).  
+   - On tag, publish `core` and `blog` packages to your private registry.  
+
+9. **Document Extension Points**  
+   - Provide a **Developer Handbook** (README + `docs/extension-points.md`).  
+
+10. **Iterate** – add Notification, Scheduler, Multitenancy, API‑Gateway as needed.
+
+---
+
+## 9️⃣ TOOLS & LIBRARIES (starter suggestions per stack)
+
+| Stack | Core | Auth | DI / Module | Event Bus | ORM | Validation | Testing |
+|-------|------|------|-------------|-----------|-----|------------|---------|
+| **Node (TypeScript)** | NestJS (or Fastify + `awilix`) | `@nestjs/passport`, `passport-jwt`, `openid-client` | NestJS dynamic modules or `@nestjs-modules/mailer` | `@nestjs/event-emitter` or `KafkaJS` | TypeORM / Prisma | `class-validator` + `class-transformer` | Jest + `supertest`, Testcontainers |
+| **Java** | Spring Boot | Spring Security + `spring-boot-starter-oauth2-resource-server` | Spring Boot `@Configuration` + `ImportBeanDefinitionRegistrar` | Spring Cloud Stream (Kafka) | JPA / Hibernate | Bean Validation (Hibernate Validator) | JUnit5 + Testcontainers |
+| **.NET 8** | ASP.NET Core | `Microsoft.AspNetCore.Authentication.JwtBearer` | `IHostedService` + `Scrutor` for module discovery | MassTransit (Rabbit/Kafka) | EF Core | FluentValidation | xUnit + DockerTestContainers |
+| **Go** | Echo / Fiber | `golang.org/x/oauth2` + `github.com/golang-jwt/jwt/v5` | `uber-go/fx` for DI, module registration | `segmentio/kafka-go` | GORM / Ent | `go-playground/validator` | Testify + Dockertest |
+| **Python** | FastAPI | `fastapi-users` / `Authlib` | `pluggy` (pytest plugins) or custom loader | `aiokafka` | SQLModel / Tortoise ORM | Pydantic | Pytest + pytest‑asyncio, Testcontainers |
+
+Pick the stack you’re most comfortable with; the concepts stay identical.
+
+---
+
+## 🎉 TL;DR – What You Must Deliver
+
+| Layer | Must‑have components | Why |
+|-------|----------------------|-----|
+| **Core Kernel** | Config, Logger, DI, Health, Metrics, Error Bus | Foundation for any module. |
+| **Security** | Auth (JWT/OIDC), Authorization (RBAC + ABAC), Audit | Guarantees secure, traceable access. |
+| **User & Role Management** | User CRUD, Password reset, Role ↔ Permission matrix | The “identity” piece everyone will reuse. |
+| **Extension System** | `IModuleInitializer`, `module.yaml`, EventBus, Permission DSL | Enables plug‑ins without touching core. |
+| **Infrastructure Adapters** | DB repo, Cache, Queue, Blob storage, Email/SMS | Keeps core agnostic to any concrete tech. |
+| **Observability** | Structured logs, Prometheus metrics, OpenTelemetry traces | You can monitor each module individually. |
+| **DevOps Boilerplate** | CI pipelines, Dockerfiles, Semantic‑release, Docs | Makes the framework production‑ready out‑of‑the‑box. |
+| **Sample Feature Module** | (e.g., Blog) to show how to add routes, permissions, DB entities | Provides a reference implementation for future developers. |
+
+When you scaffold those pieces **once**, any downstream team can drop a new folder that follows the `module.yaml` contract, implement the initializer, add its own tables & APIs, and instantly get:
+
+* secure authentication,
+* role‑based authorization,
+* logging/metrics,
+* unified config,
+* CI‑ready testing,
+* optional multi‑tenant isolation.
+
+That’s the foundation of a **robust, future‑proof platform boilerplate**. Happy building! 🚀
\ No newline at end of file
diff --git a/docs/stories/COMPLETE_TASK_LIST.md b/docs/stories/COMPLETE_TASK_LIST.md
new file mode 100644
index 0000000..81c1d53
--- /dev/null
+++ b/docs/stories/COMPLETE_TASK_LIST.md
@@ -0,0 +1,62 @@
+# Complete Task List
+
+This document provides a comprehensive list of all tasks across all phases. Each task has a corresponding detailed file in the phase-specific directories.
+
+## Task Organization
+
+Tasks are organized by phase and section. Each task file follows the naming convention: `{section}.{subtask}-{description}.md`
+
+## Phase 0: Project Setup & Foundation
+
+### 0.1 Repository Bootstrap
+- [0.1.1 - Initialize Go Module](./phase0/0.1.1-initialize-go-module.md)
+- [0.1.2 - Create Directory Structure](./phase0/0.1.2-create-directory-structure.md)
+- [0.1.3 - Add Gitignore](./phase0/0.1.3-add-gitignore.md)
+- [0.1.4 - Create Initial README](./phase0/0.1.4-create-initial-readme.md)
+
+### 0.2 Configuration System
+- [0.2.1 - Install Configuration Dependencies](./phase0/0.2.1-install-config-dependencies.md)
+- [0.2.2 - Create Config Interface](./phase0/0.2.2-create-config-interface.md)
+- [0.2.3 - Implement Config Loader](./phase0/0.2.3-implement-config-loader.md)
+- [0.2.4 - Create Configuration Files](./phase0/0.2.4-create-configuration-files.md)
+
+### 0.3 Logging Foundation
+- [0.3.1 - Install Logging Dependencies](./phase0/0.3.1-install-logging-dependencies.md)
+- See [Phase 0 README](./phase0/README.md) for remaining tasks
+
+### 0.4 Basic CI/CD Pipeline
+- See [Phase 0 README](./phase0/README.md) for tasks
+
+### 0.5 Dependency Injection Setup
+- See [Phase 0 README](./phase0/README.md) for tasks
+
+## Phase 1-8 Tasks
+
+Detailed task files for Phases 1-8 are being created. See individual phase README files:
+- [Phase 1 README](./phase1/README.md) - Core Kernel & Infrastructure
+- [Phase 2 README](./phase2/README.md) - Authentication & Authorization
+- [Phase 3 README](./phase3/README.md) - Module Framework
+- [Phase 4 README](./phase4/README.md) - Sample Feature Module (Blog)
+- [Phase 5 README](./phase5/README.md) - Infrastructure Adapters
+- [Phase 6 README](./phase6/README.md) - Observability & Production Readiness
+- [Phase 7 README](./phase7/README.md) - Testing, Documentation & CI/CD
+- [Phase 8 README](./phase8/README.md) - Advanced Features & Polish
+
+## Task Status Tracking
+
+To track task completion:
+1. Update the Status field in each task file
+2. Update checkboxes in the main plan.md
+3. Reference task IDs in commit messages: `[0.1.1] Initialize Go module`
+4. Link GitHub issues to tasks if using issue tracking
+
+## Generating Missing Task Files
+
+A script is available to generate task files from plan.md:
+```bash
+cd docs/tasks
+python3 generate_tasks.py
+```
+
+Note: Manually review and refine generated task files as needed.
+
diff --git a/docs/stories/README.md b/docs/stories/README.md
new file mode 100644
index 0000000..6b2741f
--- /dev/null
+++ b/docs/stories/README.md
@@ -0,0 +1,63 @@
+# Implementation Tasks
+
+This directory contains detailed task definitions for each phase of the Go Platform implementation.
+
+## Task Organization
+
+Tasks are organized by phase, with each major task section having its own detailed file:
+
+### Phase 0: Project Setup & Foundation
+- [Phase 0 Tasks](./phase0/README.md) - All Phase 0 tasks
+
+### Phase 1: Core Kernel & Infrastructure
+- [Phase 1 Tasks](./phase1/README.md) - All Phase 1 tasks
+
+### Phase 2: Authentication & Authorization
+- [Phase 2 Tasks](./phase2/README.md) - All Phase 2 tasks
+
+### Phase 3: Module Framework
+- [Phase 3 Tasks](./phase3/README.md) - All Phase 3 tasks
+
+### Phase 4: Sample Feature Module (Blog)
+- [Phase 4 Tasks](./phase4/README.md) - All Phase 4 tasks
+
+### Phase 5: Infrastructure Adapters
+- [Phase 5 Tasks](./phase5/README.md) - All Phase 5 tasks
+
+### Phase 6: Observability & Production Readiness
+- [Phase 6 Tasks](./phase6/README.md) - All Phase 6 tasks
+
+### Phase 7: Testing, Documentation & CI/CD
+- [Phase 7 Tasks](./phase7/README.md) - All Phase 7 tasks
+
+### Phase 8: Advanced Features & Polish (Optional)
+- [Phase 8 Tasks](./phase8/README.md) - All Phase 8 tasks
+
+## Task Status
+
+Each task file includes:
+- **Task ID**: Unique identifier (e.g., `0.1.1`)
+- **Title**: Descriptive task name
+- **Phase**: Implementation phase
+- **Status**: Pending | In Progress | Completed | Blocked
+- **Priority**: High | Medium | Low
+- **Dependencies**: Tasks that must complete first
+- **Description**: Detailed requirements
+- **Acceptance Criteria**: How to verify completion
+- **Implementation Notes**: Technical details and references
+- **Related ADRs**: Links to relevant architecture decisions
+
+## Task Tracking
+
+Tasks can be tracked using:
+- GitHub Issues (linked from tasks)
+- Project boards
+- Task management tools
+- Direct commit messages referencing task IDs
+
+## Task Naming Convention
+
+Tasks follow the format: `{phase}.{section}.{subtask}`
+
+Example: `0.1.1` = Phase 0, Section 1 (Repository Bootstrap), Subtask 1
+
diff --git a/docs/stories/TASK_TEMPLATE.md b/docs/stories/TASK_TEMPLATE.md
new file mode 100644
index 0000000..65de870
--- /dev/null
+++ b/docs/stories/TASK_TEMPLATE.md
@@ -0,0 +1,54 @@
+# Task Template
+
+Use this template for creating new task files.
+
+## Metadata
+- **Task ID**: {phase}.{section}.{subtask}
+- **Title**: {Descriptive Task Name}
+- **Phase**: {Phase Number} - {Phase Name}
+- **Section**: {Section Number}.{Section Name}
+- **Status**: Pending | In Progress | Completed | Blocked
+- **Priority**: High | Medium | Low
+- **Estimated Time**: {time estimate}
+- **Dependencies**: {task IDs that must complete first}
+
+## Description
+{Clear description of what needs to be done}
+
+## Requirements
+- {Requirement 1}
+- {Requirement 2}
+- {Requirement 3}
+
+## Implementation Steps
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+
+## Acceptance Criteria
+- [ ] {Criterion 1}
+- [ ] {Criterion 2}
+- [ ] {Criterion 3}
+
+## Related ADRs
+- [ADR-XXXX: {ADR Title}](../../adr/XXXX-adr-title.md)
+
+## Implementation Notes
+- {Note 1}
+- {Note 2}
+- {Note 3}
+
+## Testing
+```bash
+# Test commands
+go test ./...
+```
+
+## Files to Create/Modify
+- `path/to/file.go` - {Description}
+- `path/to/file_test.go` - {Description}
+
+## References
+- {Link to relevant documentation}
+- {Link to example code}
+
diff --git a/docs/stories/generate_tasks.py b/docs/stories/generate_tasks.py
new file mode 100644
index 0000000..4f2f986
--- /dev/null
+++ b/docs/stories/generate_tasks.py
@@ -0,0 +1,219 @@
+#!/usr/bin/env python3
+"""
+Generate task files from plan.md
+This script parses the plan.md file and creates detailed task files for each task.
+"""
+
+import re
+import os
+from pathlib import Path
+
+def parse_plan(plan_path):
+    """Parse plan.md and extract tasks"""
+    with open(plan_path, 'r') as f:
+        content = f.read()
+    
+    tasks = []
+    current_phase = None
+    current_section = None
+    subtask_num = 1
+    
+    lines = content.split('\n')
+    i = 0
+    while i < len(lines):
+        line = lines[i].rstrip()
+        
+        # Phase header
+        phase_match = re.match(r'^## Phase (\d+):', line)
+        if phase_match:
+            current_phase = int(phase_match.group(1))
+            subtask_num = 1  # Reset subtask counter for new phase
+            i += 1
+            continue
+        
+        # Section header (e.g., "#### 0.1 Repository Bootstrap")
+        section_match = re.match(r'^#### (\d+\.\d+)', line)
+        if section_match:
+            current_section = section_match.group(1)
+            subtask_num = 1  # Reset subtask counter for new section
+            i += 1
+            continue
+        
+        # Task item (checkbox) - must match exactly
+        task_match = re.match(r'^- \[ \] (.+)', line)
+        if task_match and current_phase is not None and current_section is not None:
+            task_desc = task_match.group(1).strip()
+            
+            # Handle tasks that end with colon (might have code block or list following)
+            code_block = ""
+            # Skip empty lines and code blocks
+            if i + 1 < len(lines):
+                next_line = lines[i + 1].strip()
+                if next_line.startswith('```'):
+                    # Extract code block
+                    j = i + 2
+                    while j < len(lines) and not lines[j].strip().startswith('```'):
+                        code_block += lines[j] + '\n'
+                        j += 1
+                    i = j + 1
+                elif next_line.startswith('- [ ]') or next_line.startswith('```'):
+                    # Next task or code block, don't skip
+                    i += 1
+                else:
+                    i += 1
+            else:
+                i += 1
+            
+            # Only add if we have valid phase and section
+            if current_phase is not None and current_section is not None:
+                tasks.append({
+                    'phase': current_phase,
+                    'section': current_section,
+                    'subtask': subtask_num,
+                    'description': task_desc,
+                    'code': code_block.strip()
+                })
+                subtask_num += 1
+            continue
+        
+        i += 1
+    
+    return tasks
+
+def create_task_file(task, output_dir):
+    """Create a task markdown file"""
+    phase_dir = output_dir / f"phase{task['phase']}"
+    phase_dir.mkdir(exist_ok=True)
+    
+    task_id = f"{task['section']}.{task['subtask']}"
+    # Create safe filename
+    safe_desc = re.sub(r'[^\w\s-]', '', task['description'])[:50].strip().replace(' ', '-').lower()
+    filename = f"{task_id}-{safe_desc}.md"
+    filepath = phase_dir / filename
+    
+    # Generate content
+    content = f"""# Task {task_id}: {task['description']}
+
+## Metadata
+- **Task ID**: {task_id}
+- **Title**: {task['description']}
+- **Phase**: {task['phase']} - {get_phase_name(task['phase'])}
+- **Section**: {task['section']}
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+{task['description']}
+
+## Requirements
+- {task['description']}
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task {task_id} is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+"""
+    
+    if task['code']:
+        content += f"\n## Code Reference\n\n```go\n{task['code']}\n```\n"
+    
+    with open(filepath, 'w') as f:
+        f.write(content)
+    
+    return filepath
+
+def get_phase_name(phase_num):
+    """Get phase name from number"""
+    phases = {
+        0: "Project Setup & Foundation",
+        1: "Core Kernel & Infrastructure",
+        2: "Authentication & Authorization",
+        3: "Module Framework",
+        4: "Sample Feature Module (Blog)",
+        5: "Infrastructure Adapters",
+        6: "Observability & Production Readiness",
+        7: "Testing, Documentation & CI/CD",
+        8: "Advanced Features & Polish"
+    }
+    return phases.get(phase_num, "Unknown")
+
+def main():
+    script_dir = Path(__file__).parent
+    plan_path = script_dir.parent / "plan.md"
+    output_dir = script_dir
+    
+    if not plan_path.exists():
+        print(f"Error: {plan_path} not found")
+        return
+    
+    print(f"Parsing {plan_path}...")
+    try:
+        tasks = parse_plan(plan_path)
+        print(f"Found {len(tasks)} tasks")
+        
+        if len(tasks) == 0:
+            print("Warning: No tasks found. Check the plan.md format.")
+            return
+        
+        created = 0
+        skipped = 0
+        for task in tasks:
+            try:
+                task_id = f"{task['section']}.{task['subtask']}"
+                
+                # Determine filepath before creating
+                phase_dir = output_dir / f"phase{task['phase']}"
+                phase_dir.mkdir(exist_ok=True)
+                
+                # Create safe filename
+                safe_desc = re.sub(r'[^\w\s-]', '', task['description'])[:50].strip().replace(' ', '-').lower()
+                filename = f"{task_id}-{safe_desc}.md"
+                filepath = phase_dir / filename
+                
+                # Check if file already exists (skip if so)
+                if filepath.exists() and filepath.stat().st_size > 100:
+                    skipped += 1
+                    continue
+                
+                # Create the file
+                create_task_file(task, output_dir)
+                created += 1
+                if created % 10 == 0:
+                    print(f"Created {created} task files...")
+            except Exception as e:
+                print(f"Error creating task {task.get('section', '?')}.{task.get('subtask', '?')}: {e}")
+                import traceback
+                traceback.print_exc()
+        
+        print(f"\nCreated {created} new task files")
+        if skipped > 0:
+            print(f"Skipped {skipped} existing task files")
+        print(f"Total tasks processed: {len(tasks)}")
+    except Exception as e:
+        print(f"Error: {e}")
+        import traceback
+        traceback.print_exc()
+
+if __name__ == '__main__':
+    main()
+
diff --git a/docs/stories/phase0/0.1.1-initialize-go-module-go-mod-init-githubcomyourorgp.md b/docs/stories/phase0/0.1.1-initialize-go-module-go-mod-init-githubcomyourorgp.md
new file mode 100644
index 0000000..5607dd4
--- /dev/null
+++ b/docs/stories/phase0/0.1.1-initialize-go-module-go-mod-init-githubcomyourorgp.md
@@ -0,0 +1,47 @@
+# Task 0.1.1: Initialize Go Module
+
+## Metadata
+- **Task ID**: 0.1.1
+- **Title**: Initialize Go Module
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1 Repository Bootstrap
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 5 minutes
+- **Dependencies**: None
+
+## Description
+Initialize the Go module with the correct module path for the platform.
+
+## Requirements
+- Use module path: `git.dcentral.systems/toolz/goplt`
+- Go version: 1.24.3
+- Ensure `go.mod` file is created correctly
+
+## Implementation Steps
+1. Run `go mod init git.dcentral.systems/toolz/goplt` in the project root
+2. Verify `go.mod` file is created with correct module path
+3. Set Go version in `go.mod`: `go 1.24`
+
+## Acceptance Criteria
+- [ ] `go.mod` file exists in project root
+- [ ] Module path is `git.dcentral.systems/toolz/goplt`
+- [ ] Go version is set to `1.24`
+- [ ] `go mod verify` passes
+
+## Related ADRs
+- [ADR-0001: Go Module Path](../../adr/0001-go-module-path.md)
+- [ADR-0002: Go Version](../../adr/0002-go-version.md)
+
+## Implementation Notes
+- Ensure the module path matches the organization's Git hosting structure
+- The module path will be used for all internal imports
+- Update any documentation that references placeholder module paths
+
+## Testing
+```bash
+# Verify module initialization
+go mod verify
+go mod tidy
+```
+
diff --git a/docs/stories/phase0/0.1.1-initialize-go-module.md b/docs/stories/phase0/0.1.1-initialize-go-module.md
new file mode 100644
index 0000000..5607dd4
--- /dev/null
+++ b/docs/stories/phase0/0.1.1-initialize-go-module.md
@@ -0,0 +1,47 @@
+# Task 0.1.1: Initialize Go Module
+
+## Metadata
+- **Task ID**: 0.1.1
+- **Title**: Initialize Go Module
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1 Repository Bootstrap
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 5 minutes
+- **Dependencies**: None
+
+## Description
+Initialize the Go module with the correct module path for the platform.
+
+## Requirements
+- Use module path: `git.dcentral.systems/toolz/goplt`
+- Go version: 1.24.3
+- Ensure `go.mod` file is created correctly
+
+## Implementation Steps
+1. Run `go mod init git.dcentral.systems/toolz/goplt` in the project root
+2. Verify `go.mod` file is created with correct module path
+3. Set Go version in `go.mod`: `go 1.24`
+
+## Acceptance Criteria
+- [ ] `go.mod` file exists in project root
+- [ ] Module path is `git.dcentral.systems/toolz/goplt`
+- [ ] Go version is set to `1.24`
+- [ ] `go mod verify` passes
+
+## Related ADRs
+- [ADR-0001: Go Module Path](../../adr/0001-go-module-path.md)
+- [ADR-0002: Go Version](../../adr/0002-go-version.md)
+
+## Implementation Notes
+- Ensure the module path matches the organization's Git hosting structure
+- The module path will be used for all internal imports
+- Update any documentation that references placeholder module paths
+
+## Testing
+```bash
+# Verify module initialization
+go mod verify
+go mod tidy
+```
+
diff --git a/docs/stories/phase0/0.1.2-create-directory-structure.md b/docs/stories/phase0/0.1.2-create-directory-structure.md
new file mode 100644
index 0000000..1ec1250
--- /dev/null
+++ b/docs/stories/phase0/0.1.2-create-directory-structure.md
@@ -0,0 +1,77 @@
+# Task 0.1.2: Create directory structure:
+
+## Metadata
+- **Task ID**: 0.1.2
+- **Title**: Create directory structure:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create directory structure:
+
+## Requirements
+- Create directory structure:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+platform/
+  ├── cmd/
+  │   └── platform/          # Main entry point
+  ├── internal/              # Private implementation code
+  │   ├── di/                # Dependency injection container
+  │   ├── registry/          # Module registry
+  │   ├── pluginloader/      # Plugin loader (optional)
+  │   └── infra/             # Infrastructure adapters
+  ├── pkg/                   # Public interfaces (exported)
+  │   ├── config/            # ConfigProvider interface
+  │   ├── logger/            # Logger interface
+  │   ├── module/            # IModule interface
+  │   ├── auth/              # Auth interfaces
+  │   ├── perm/              # Permission DSL
+  │   └── infra/             # Infrastructure interfaces
+  ├── modules/               # Feature modules
+  │   └── blog/              # Sample Blog module (Phase 4)
+  ├── config/                # Configuration files
+  │   ├── default.yaml
+  │   ├── development.yaml
+  │   └── production.yaml
+  ├── api/                   # OpenAPI specs
+  ├── scripts/               # Build/test scripts
+  ├── docs/                  # Documentation
+  ├── ops/                   # Operations (Grafana dashboards, etc.)
+  ├── .github/
+  │   └── workflows/
+  │       └── ci.yml
+  ├── Dockerfile
+  ├── docker-compose.yml
+  ├── docker-compose.test.yml
+  └── go.mod
+```
diff --git a/docs/stories/phase0/0.1.3-add-gitignore-for-go-projects.md b/docs/stories/phase0/0.1.3-add-gitignore-for-go-projects.md
new file mode 100644
index 0000000..b1c068f
--- /dev/null
+++ b/docs/stories/phase0/0.1.3-add-gitignore-for-go-projects.md
@@ -0,0 +1,56 @@
+# Task 0.1.3: Add Gitignore
+
+## Metadata
+- **Task ID**: 0.1.3
+- **Title**: Add Gitignore
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1 Repository Bootstrap
+- **Status**: Pending
+- **Priority**: Medium
+- **Estimated Time**: 5 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Create a comprehensive `.gitignore` file for Go projects that excludes build artifacts, dependencies, IDE files, and sensitive data.
+
+## Requirements
+- Ignore Go build artifacts
+- Ignore dependency caches
+- Ignore IDE-specific files
+- Ignore environment-specific files
+- Ignore secrets and sensitive data
+
+## Implementation Steps
+1. Create `.gitignore` in project root
+2. Add standard Go ignores:
+   - `*.exe`, `*.exe~`, `*.dll`, `*.so`, `*.dylib`
+   - `*.test`, `*.out`
+   - `go.work`, `go.work.sum`
+3. Add IDE ignores:
+   - `.vscode/`, `.idea/`, `*.swp`, `*.swo`
+4. Add environment ignores:
+   - `.env`, `.env.local`, `config/secrets/`
+5. Add OS ignores:
+   - `.DS_Store`, `Thumbs.db`
+6. Add build artifacts:
+   - `bin/`, `dist/`, `tmp/`
+
+## Acceptance Criteria
+- [ ] `.gitignore` file exists
+- [ ] Common Go artifacts are ignored
+- [ ] IDE files are ignored
+- [ ] Sensitive files are ignored
+- [ ] Test with `git status` to verify
+
+## Implementation Notes
+- Use standard Go `.gitignore` templates
+- Ensure `config/secrets/` is ignored (for secret files)
+- Consider adding `*.log` for log files
+
+## Testing
+```bash
+# Verify gitignore works
+git status
+# Should not show build artifacts or IDE files
+```
+
diff --git a/docs/stories/phase0/0.1.3-add-gitignore.md b/docs/stories/phase0/0.1.3-add-gitignore.md
new file mode 100644
index 0000000..b1c068f
--- /dev/null
+++ b/docs/stories/phase0/0.1.3-add-gitignore.md
@@ -0,0 +1,56 @@
+# Task 0.1.3: Add Gitignore
+
+## Metadata
+- **Task ID**: 0.1.3
+- **Title**: Add Gitignore
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1 Repository Bootstrap
+- **Status**: Pending
+- **Priority**: Medium
+- **Estimated Time**: 5 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Create a comprehensive `.gitignore` file for Go projects that excludes build artifacts, dependencies, IDE files, and sensitive data.
+
+## Requirements
+- Ignore Go build artifacts
+- Ignore dependency caches
+- Ignore IDE-specific files
+- Ignore environment-specific files
+- Ignore secrets and sensitive data
+
+## Implementation Steps
+1. Create `.gitignore` in project root
+2. Add standard Go ignores:
+   - `*.exe`, `*.exe~`, `*.dll`, `*.so`, `*.dylib`
+   - `*.test`, `*.out`
+   - `go.work`, `go.work.sum`
+3. Add IDE ignores:
+   - `.vscode/`, `.idea/`, `*.swp`, `*.swo`
+4. Add environment ignores:
+   - `.env`, `.env.local`, `config/secrets/`
+5. Add OS ignores:
+   - `.DS_Store`, `Thumbs.db`
+6. Add build artifacts:
+   - `bin/`, `dist/`, `tmp/`
+
+## Acceptance Criteria
+- [ ] `.gitignore` file exists
+- [ ] Common Go artifacts are ignored
+- [ ] IDE files are ignored
+- [ ] Sensitive files are ignored
+- [ ] Test with `git status` to verify
+
+## Implementation Notes
+- Use standard Go `.gitignore` templates
+- Ensure `config/secrets/` is ignored (for secret files)
+- Consider adding `*.log` for log files
+
+## Testing
+```bash
+# Verify gitignore works
+git status
+# Should not show build artifacts or IDE files
+```
+
diff --git a/docs/stories/phase0/0.1.4-create-initial-readme.md b/docs/stories/phase0/0.1.4-create-initial-readme.md
new file mode 100644
index 0000000..3bc4a22
--- /dev/null
+++ b/docs/stories/phase0/0.1.4-create-initial-readme.md
@@ -0,0 +1,63 @@
+# Task 0.1.4: Create Initial README
+
+## Metadata
+- **Task ID**: 0.1.4
+- **Title**: Create Initial README
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1 Repository Bootstrap
+- **Status**: Pending
+- **Priority**: Medium
+- **Estimated Time**: 20 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Create an initial `README.md` file that provides an overview of the project, its purpose, architecture, and quick start instructions.
+
+## Requirements
+- Project overview and description
+- Architecture overview
+- Quick start guide
+- Links to documentation
+- Build and run instructions
+
+## Implementation Steps
+1. Create `README.md` in project root
+2. Add project title and description
+3. Add architecture overview section
+4. Add quick start instructions
+5. Add links to documentation (`docs/`)
+6. Add build and run commands
+7. Add contribution guidelines (placeholder)
+
+## Acceptance Criteria
+- [ ] `README.md` exists
+- [ ] Project overview is clear
+- [ ] Quick start instructions are present
+- [ ] Links to documentation work
+- [ ] Build instructions are accurate
+
+## Implementation Notes
+- Keep README concise but informative
+- Update as project evolves
+- Include badges (build status, etc.) later
+- Reference ADRs for architecture decisions
+
+## Content Structure
+```markdown
+# Go Platform (goplt)
+
+[Description]
+
+## Architecture
+[Overview]
+
+## Quick Start
+[Instructions]
+
+## Documentation
+[Links]
+
+## Development
+[Setup instructions]
+```
+
diff --git a/docs/stories/phase0/0.1.4-create-initial-readmemd-with-project-overview.md b/docs/stories/phase0/0.1.4-create-initial-readmemd-with-project-overview.md
new file mode 100644
index 0000000..3bc4a22
--- /dev/null
+++ b/docs/stories/phase0/0.1.4-create-initial-readmemd-with-project-overview.md
@@ -0,0 +1,63 @@
+# Task 0.1.4: Create Initial README
+
+## Metadata
+- **Task ID**: 0.1.4
+- **Title**: Create Initial README
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1 Repository Bootstrap
+- **Status**: Pending
+- **Priority**: Medium
+- **Estimated Time**: 20 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Create an initial `README.md` file that provides an overview of the project, its purpose, architecture, and quick start instructions.
+
+## Requirements
+- Project overview and description
+- Architecture overview
+- Quick start guide
+- Links to documentation
+- Build and run instructions
+
+## Implementation Steps
+1. Create `README.md` in project root
+2. Add project title and description
+3. Add architecture overview section
+4. Add quick start instructions
+5. Add links to documentation (`docs/`)
+6. Add build and run commands
+7. Add contribution guidelines (placeholder)
+
+## Acceptance Criteria
+- [ ] `README.md` exists
+- [ ] Project overview is clear
+- [ ] Quick start instructions are present
+- [ ] Links to documentation work
+- [ ] Build instructions are accurate
+
+## Implementation Notes
+- Keep README concise but informative
+- Update as project evolves
+- Include badges (build status, etc.) later
+- Reference ADRs for architecture decisions
+
+## Content Structure
+```markdown
+# Go Platform (goplt)
+
+[Description]
+
+## Architecture
+[Overview]
+
+## Quick Start
+[Instructions]
+
+## Documentation
+[Links]
+
+## Development
+[Setup instructions]
+```
+
diff --git a/docs/stories/phase0/0.2.1-install-config-dependencies.md b/docs/stories/phase0/0.2.1-install-config-dependencies.md
new file mode 100644
index 0000000..667f1be
--- /dev/null
+++ b/docs/stories/phase0/0.2.1-install-config-dependencies.md
@@ -0,0 +1,47 @@
+# Task 0.2.1: Install Configuration Dependencies
+
+## Metadata
+- **Task ID**: 0.2.1
+- **Title**: Install Configuration Dependencies
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 5 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Install Viper and Cobra packages for configuration management and CLI support.
+
+## Requirements
+- Install `github.com/spf13/viper` v1.18.0+
+- Install `github.com/spf13/cobra` v1.8.0+
+- Add to `go.mod` with proper version constraints
+
+## Implementation Steps
+1. Run `go get github.com/spf13/viper@v1.18.0`
+2. Run `go get github.com/spf13/cobra@v1.8.0`
+3. Run `go mod tidy` to update dependencies
+4. Verify packages in `go.mod`
+
+## Acceptance Criteria
+- [ ] Viper is listed in `go.mod`
+- [ ] Cobra is listed in `go.mod`
+- [ ] `go mod verify` passes
+- [ ] Dependencies are properly versioned
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Use specific versions for reproducibility
+- Consider using `go get -u` for latest patch versions
+- Document version choices in ADR
+
+## Testing
+```bash
+go mod verify
+go list -m github.com/spf13/viper
+go list -m github.com/spf13/cobra
+```
+
diff --git a/docs/stories/phase0/0.2.1-install-githubcomspf13viper-and-githubcomspf13cobr.md b/docs/stories/phase0/0.2.1-install-githubcomspf13viper-and-githubcomspf13cobr.md
new file mode 100644
index 0000000..667f1be
--- /dev/null
+++ b/docs/stories/phase0/0.2.1-install-githubcomspf13viper-and-githubcomspf13cobr.md
@@ -0,0 +1,47 @@
+# Task 0.2.1: Install Configuration Dependencies
+
+## Metadata
+- **Task ID**: 0.2.1
+- **Title**: Install Configuration Dependencies
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 5 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Install Viper and Cobra packages for configuration management and CLI support.
+
+## Requirements
+- Install `github.com/spf13/viper` v1.18.0+
+- Install `github.com/spf13/cobra` v1.8.0+
+- Add to `go.mod` with proper version constraints
+
+## Implementation Steps
+1. Run `go get github.com/spf13/viper@v1.18.0`
+2. Run `go get github.com/spf13/cobra@v1.8.0`
+3. Run `go mod tidy` to update dependencies
+4. Verify packages in `go.mod`
+
+## Acceptance Criteria
+- [ ] Viper is listed in `go.mod`
+- [ ] Cobra is listed in `go.mod`
+- [ ] `go mod verify` passes
+- [ ] Dependencies are properly versioned
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Use specific versions for reproducibility
+- Consider using `go get -u` for latest patch versions
+- Document version choices in ADR
+
+## Testing
+```bash
+go mod verify
+go list -m github.com/spf13/viper
+go list -m github.com/spf13/cobra
+```
+
diff --git a/docs/stories/phase0/0.2.2-create-config-interface.md b/docs/stories/phase0/0.2.2-create-config-interface.md
new file mode 100644
index 0000000..a039a4c
--- /dev/null
+++ b/docs/stories/phase0/0.2.2-create-config-interface.md
@@ -0,0 +1,59 @@
+# Task 0.2.2: Create Config Interface
+
+## Metadata
+- **Task ID**: 0.2.2
+- **Title**: Create Config Interface
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 15 minutes
+- **Dependencies**: 0.2.1
+
+## Description
+Create the `ConfigProvider` interface in `pkg/config/` to abstract configuration access. This interface will be used by all modules and services.
+
+## Requirements
+- Define interface in `pkg/config/config.go`
+- Include methods for type-safe access
+- Support nested configuration keys
+- Support unmarshaling into structs
+
+## Implementation Steps
+1. Create `pkg/config/config.go`
+2. Define `ConfigProvider` interface:
+   ```go
+   type ConfigProvider interface {
+       Get(key string) any
+       Unmarshal(v any) error
+       GetString(key string) string
+       GetInt(key string) int
+       GetBool(key string) bool
+       GetStringSlice(key string) []string
+   }
+   ```
+3. Add package documentation
+4. Export interface for use by modules
+
+## Acceptance Criteria
+- [ ] `pkg/config/config.go` exists
+- [ ] `ConfigProvider` interface is defined
+- [ ] Interface methods match requirements
+- [ ] Package documentation is present
+- [ ] Interface compiles without errors
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Interface should be minimal and focused
+- Additional methods can be added later if needed
+- Consider adding `GetDuration()` for time.Duration values
+- Consider adding `IsSet(key string) bool` to check if key exists
+
+## Testing
+```bash
+go build ./pkg/config
+go vet ./pkg/config
+```
+
diff --git a/docs/stories/phase0/0.2.2-create-pkgconfigconfiggo-interface.md b/docs/stories/phase0/0.2.2-create-pkgconfigconfiggo-interface.md
new file mode 100644
index 0000000..a039a4c
--- /dev/null
+++ b/docs/stories/phase0/0.2.2-create-pkgconfigconfiggo-interface.md
@@ -0,0 +1,59 @@
+# Task 0.2.2: Create Config Interface
+
+## Metadata
+- **Task ID**: 0.2.2
+- **Title**: Create Config Interface
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 15 minutes
+- **Dependencies**: 0.2.1
+
+## Description
+Create the `ConfigProvider` interface in `pkg/config/` to abstract configuration access. This interface will be used by all modules and services.
+
+## Requirements
+- Define interface in `pkg/config/config.go`
+- Include methods for type-safe access
+- Support nested configuration keys
+- Support unmarshaling into structs
+
+## Implementation Steps
+1. Create `pkg/config/config.go`
+2. Define `ConfigProvider` interface:
+   ```go
+   type ConfigProvider interface {
+       Get(key string) any
+       Unmarshal(v any) error
+       GetString(key string) string
+       GetInt(key string) int
+       GetBool(key string) bool
+       GetStringSlice(key string) []string
+   }
+   ```
+3. Add package documentation
+4. Export interface for use by modules
+
+## Acceptance Criteria
+- [ ] `pkg/config/config.go` exists
+- [ ] `ConfigProvider` interface is defined
+- [ ] Interface methods match requirements
+- [ ] Package documentation is present
+- [ ] Interface compiles without errors
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Interface should be minimal and focused
+- Additional methods can be added later if needed
+- Consider adding `GetDuration()` for time.Duration values
+- Consider adding `IsSet(key string) bool` to check if key exists
+
+## Testing
+```bash
+go build ./pkg/config
+go vet ./pkg/config
+```
+
diff --git a/docs/stories/phase0/0.2.3-implement-config-loader.md b/docs/stories/phase0/0.2.3-implement-config-loader.md
new file mode 100644
index 0000000..24e1883
--- /dev/null
+++ b/docs/stories/phase0/0.2.3-implement-config-loader.md
@@ -0,0 +1,60 @@
+# Task 0.2.3: Implement Config Loader
+
+## Metadata
+- **Task ID**: 0.2.3
+- **Title**: Implement Config Loader
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 30 minutes
+- **Dependencies**: 0.2.1, 0.2.2
+
+## Description
+Implement the Viper-based configuration loader in `internal/config/` that implements the `ConfigProvider` interface. This loader will handle hierarchical configuration loading from files and environment variables.
+
+## Requirements
+- Implement `ConfigProvider` interface using Viper
+- Load configuration in order: defaults → environment-specific → env vars
+- Support YAML configuration files
+- Support environment variable overrides
+- Provide placeholder for secret manager integration (Phase 6)
+
+## Implementation Steps
+1. Create `internal/config/config.go`:
+   - Implement `ConfigProvider` interface
+   - Wrap Viper instance
+   - Implement all interface methods
+2. Create `internal/config/loader.go`:
+   - `LoadConfig()` function
+   - Load `config/default.yaml` as baseline
+   - Merge environment-specific YAML (development/production)
+   - Apply environment variable overrides
+   - Set up automatic environment variable binding
+3. Add error handling for missing config files
+4. Add logging for configuration loading
+
+## Acceptance Criteria
+- [ ] `internal/config/config.go` implements `ConfigProvider`
+- [ ] `internal/config/loader.go` has `LoadConfig()` function
+- [ ] Configuration loads from `config/default.yaml`
+- [ ] Environment-specific configs are merged correctly
+- [ ] Environment variables override file values
+- [ ] Errors are handled gracefully
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Use Viper's `SetConfigName()` and `AddConfigPath()`
+- Use `MergeInConfig()` for environment-specific files
+- Use `AutomaticEnv()` for environment variable binding
+- Set environment variable prefix (e.g., `GOPLT_`)
+- Use `SetEnvKeyReplacer()` to replace dots with underscores
+
+## Testing
+```bash
+# Test config loading
+go test ./internal/config -v
+```
+
diff --git a/docs/stories/phase0/0.2.3-implement-internalconfigconfiggo-using-viper.md b/docs/stories/phase0/0.2.3-implement-internalconfigconfiggo-using-viper.md
new file mode 100644
index 0000000..24e1883
--- /dev/null
+++ b/docs/stories/phase0/0.2.3-implement-internalconfigconfiggo-using-viper.md
@@ -0,0 +1,60 @@
+# Task 0.2.3: Implement Config Loader
+
+## Metadata
+- **Task ID**: 0.2.3
+- **Title**: Implement Config Loader
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 30 minutes
+- **Dependencies**: 0.2.1, 0.2.2
+
+## Description
+Implement the Viper-based configuration loader in `internal/config/` that implements the `ConfigProvider` interface. This loader will handle hierarchical configuration loading from files and environment variables.
+
+## Requirements
+- Implement `ConfigProvider` interface using Viper
+- Load configuration in order: defaults → environment-specific → env vars
+- Support YAML configuration files
+- Support environment variable overrides
+- Provide placeholder for secret manager integration (Phase 6)
+
+## Implementation Steps
+1. Create `internal/config/config.go`:
+   - Implement `ConfigProvider` interface
+   - Wrap Viper instance
+   - Implement all interface methods
+2. Create `internal/config/loader.go`:
+   - `LoadConfig()` function
+   - Load `config/default.yaml` as baseline
+   - Merge environment-specific YAML (development/production)
+   - Apply environment variable overrides
+   - Set up automatic environment variable binding
+3. Add error handling for missing config files
+4. Add logging for configuration loading
+
+## Acceptance Criteria
+- [ ] `internal/config/config.go` implements `ConfigProvider`
+- [ ] `internal/config/loader.go` has `LoadConfig()` function
+- [ ] Configuration loads from `config/default.yaml`
+- [ ] Environment-specific configs are merged correctly
+- [ ] Environment variables override file values
+- [ ] Errors are handled gracefully
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Use Viper's `SetConfigName()` and `AddConfigPath()`
+- Use `MergeInConfig()` for environment-specific files
+- Use `AutomaticEnv()` for environment variable binding
+- Set environment variable prefix (e.g., `GOPLT_`)
+- Use `SetEnvKeyReplacer()` to replace dots with underscores
+
+## Testing
+```bash
+# Test config loading
+go test ./internal/config -v
+```
+
diff --git a/docs/stories/phase0/0.2.4-create-configdefaultyaml-with-basic-structure.md b/docs/stories/phase0/0.2.4-create-configdefaultyaml-with-basic-structure.md
new file mode 100644
index 0000000..c6f3f6e
--- /dev/null
+++ b/docs/stories/phase0/0.2.4-create-configdefaultyaml-with-basic-structure.md
@@ -0,0 +1,67 @@
+# Task 0.2.4: Create Configuration Files
+
+## Metadata
+- **Task ID**: 0.2.4
+- **Title**: Create Configuration Files
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 15 minutes
+- **Dependencies**: 0.1.2
+
+## Description
+Create the baseline configuration YAML files that define the default configuration structure for the platform.
+
+## Requirements
+- Create `config/default.yaml` with baseline values
+- Create `config/development.yaml` with development overrides
+- Create `config/production.yaml` with production overrides
+- Define configuration schema for all core services
+
+## Implementation Steps
+1. Create `config/default.yaml`:
+   ```yaml
+   environment: development
+   server:
+     port: 8080
+     host: "0.0.0.0"
+   database:
+     driver: "postgres"
+     dsn: ""
+   logging:
+     level: "info"
+     format: "json"
+   ```
+2. Create `config/development.yaml`:
+   - Override logging level to "debug"
+   - Add development-specific settings
+3. Create `config/production.yaml`:
+   - Override logging level to "warn"
+   - Add production-specific settings
+4. Document configuration options
+
+## Acceptance Criteria
+- [ ] `config/default.yaml` exists with complete structure
+- [ ] `config/development.yaml` exists
+- [ ] `config/production.yaml` exists
+- [ ] All configuration files are valid YAML
+- [ ] Configuration structure is documented
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Use consistent indentation (2 spaces)
+- Add comments for unclear configuration options
+- Use environment variables for sensitive values (DSN, secrets)
+- Consider adding validation schema later
+
+## Testing
+```bash
+# Validate YAML syntax
+yamllint config/*.yaml
+# or
+python3 -c "import yaml; yaml.safe_load(open('config/default.yaml'))"
+```
+
diff --git a/docs/stories/phase0/0.2.4-create-configuration-files.md b/docs/stories/phase0/0.2.4-create-configuration-files.md
new file mode 100644
index 0000000..c6f3f6e
--- /dev/null
+++ b/docs/stories/phase0/0.2.4-create-configuration-files.md
@@ -0,0 +1,67 @@
+# Task 0.2.4: Create Configuration Files
+
+## Metadata
+- **Task ID**: 0.2.4
+- **Title**: Create Configuration Files
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2 Configuration System
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 15 minutes
+- **Dependencies**: 0.1.2
+
+## Description
+Create the baseline configuration YAML files that define the default configuration structure for the platform.
+
+## Requirements
+- Create `config/default.yaml` with baseline values
+- Create `config/development.yaml` with development overrides
+- Create `config/production.yaml` with production overrides
+- Define configuration schema for all core services
+
+## Implementation Steps
+1. Create `config/default.yaml`:
+   ```yaml
+   environment: development
+   server:
+     port: 8080
+     host: "0.0.0.0"
+   database:
+     driver: "postgres"
+     dsn: ""
+   logging:
+     level: "info"
+     format: "json"
+   ```
+2. Create `config/development.yaml`:
+   - Override logging level to "debug"
+   - Add development-specific settings
+3. Create `config/production.yaml`:
+   - Override logging level to "warn"
+   - Add production-specific settings
+4. Document configuration options
+
+## Acceptance Criteria
+- [ ] `config/default.yaml` exists with complete structure
+- [ ] `config/development.yaml` exists
+- [ ] `config/production.yaml` exists
+- [ ] All configuration files are valid YAML
+- [ ] Configuration structure is documented
+
+## Related ADRs
+- [ADR-0004: Configuration Management](../../adr/0004-configuration-management.md)
+
+## Implementation Notes
+- Use consistent indentation (2 spaces)
+- Add comments for unclear configuration options
+- Use environment variables for sensitive values (DSN, secrets)
+- Consider adding validation schema later
+
+## Testing
+```bash
+# Validate YAML syntax
+yamllint config/*.yaml
+# or
+python3 -c "import yaml; yaml.safe_load(open('config/default.yaml'))"
+```
+
diff --git a/docs/stories/phase0/0.2.5-add-internalconfigloadergo-with-loadconfig-functio.md b/docs/stories/phase0/0.2.5-add-internalconfigloadergo-with-loadconfig-functio.md
new file mode 100644
index 0000000..546b6a3
--- /dev/null
+++ b/docs/stories/phase0/0.2.5-add-internalconfigloadergo-with-loadconfig-functio.md
@@ -0,0 +1,40 @@
+# Task 0.2.5: Add `internal/config/loader.go` with `LoadConfig()` function
+
+## Metadata
+- **Task ID**: 0.2.5
+- **Title**: Add `internal/config/loader.go` with `LoadConfig()` function
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add `internal/config/loader.go` with `LoadConfig()` function
+
+## Requirements
+- Add `internal/config/loader.go` with `LoadConfig()` function
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.2.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/0.3.1-install-gouberorgzap.md b/docs/stories/phase0/0.3.1-install-gouberorgzap.md
new file mode 100644
index 0000000..972bbd9
--- /dev/null
+++ b/docs/stories/phase0/0.3.1-install-gouberorgzap.md
@@ -0,0 +1,33 @@
+# Task 0.3.1: Install Logging Dependencies
+
+## Metadata
+- **Task ID**: 0.3.1
+- **Title**: Install Logging Dependencies
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.3 Logging Foundation
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 5 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Install the Zap logging library for structured logging.
+
+## Requirements
+- Install `go.uber.org/zap` v1.26.0+
+- Add to `go.mod` with proper version constraints
+
+## Implementation Steps
+1. Run `go get go.uber.org/zap@v1.26.0`
+2. Run `go mod tidy`
+3. Verify package in `go.mod`
+
+## Acceptance Criteria
+- [ ] Zap is listed in `go.mod`
+- [ ] Version is v1.26.0 or later
+- [ ] `go mod verify` passes
+
+## Related ADRs
+- [ADR-0005: Logging Framework](../../adr/0005-logging-framework.md)
+- [ADR-0012: Logger Interface Design](../../adr/0012-logger-interface-design.md)
+
diff --git a/docs/stories/phase0/0.3.1-install-logging-dependencies.md b/docs/stories/phase0/0.3.1-install-logging-dependencies.md
new file mode 100644
index 0000000..972bbd9
--- /dev/null
+++ b/docs/stories/phase0/0.3.1-install-logging-dependencies.md
@@ -0,0 +1,33 @@
+# Task 0.3.1: Install Logging Dependencies
+
+## Metadata
+- **Task ID**: 0.3.1
+- **Title**: Install Logging Dependencies
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.3 Logging Foundation
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: 5 minutes
+- **Dependencies**: 0.1.1
+
+## Description
+Install the Zap logging library for structured logging.
+
+## Requirements
+- Install `go.uber.org/zap` v1.26.0+
+- Add to `go.mod` with proper version constraints
+
+## Implementation Steps
+1. Run `go get go.uber.org/zap@v1.26.0`
+2. Run `go mod tidy`
+3. Verify package in `go.mod`
+
+## Acceptance Criteria
+- [ ] Zap is listed in `go.mod`
+- [ ] Version is v1.26.0 or later
+- [ ] `go mod verify` passes
+
+## Related ADRs
+- [ADR-0005: Logging Framework](../../adr/0005-logging-framework.md)
+- [ADR-0012: Logger Interface Design](../../adr/0012-logger-interface-design.md)
+
diff --git a/docs/stories/phase0/0.3.2-create-pkgloggerloggergo-interface.md b/docs/stories/phase0/0.3.2-create-pkgloggerloggergo-interface.md
new file mode 100644
index 0000000..75e679a
--- /dev/null
+++ b/docs/stories/phase0/0.3.2-create-pkgloggerloggergo-interface.md
@@ -0,0 +1,52 @@
+# Task 0.3.2: Create `pkg/logger/logger.go` interface:
+
+## Metadata
+- **Task ID**: 0.3.2
+- **Title**: Create `pkg/logger/logger.go` interface:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/logger/logger.go` interface:
+
+## Requirements
+- Create `pkg/logger/logger.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Logger interface {
+      Debug(msg string, fields ...Field)
+      Info(msg string, fields ...Field)
+      Warn(msg string, fields ...Field)
+      Error(msg string, fields ...Field)
+      With(fields ...Field) Logger
+  }
+```
diff --git a/docs/stories/phase0/0.3.3-implement-internalloggerzap_loggergo.md b/docs/stories/phase0/0.3.3-implement-internalloggerzap_loggergo.md
new file mode 100644
index 0000000..b4f7310
--- /dev/null
+++ b/docs/stories/phase0/0.3.3-implement-internalloggerzap_loggergo.md
@@ -0,0 +1,40 @@
+# Task 0.3.3: Implement `internal/logger/zap_logger.go`:
+
+## Metadata
+- **Task ID**: 0.3.3
+- **Title**: Implement `internal/logger/zap_logger.go`:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/logger/zap_logger.go`:
+
+## Requirements
+- Implement `internal/logger/zap_logger.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/0.3.4-add-request-id-middleware-helper-gin-middleware.md b/docs/stories/phase0/0.3.4-add-request-id-middleware-helper-gin-middleware.md
new file mode 100644
index 0000000..c13a130
--- /dev/null
+++ b/docs/stories/phase0/0.3.4-add-request-id-middleware-helper-gin-middleware.md
@@ -0,0 +1,40 @@
+# Task 0.3.4: Add request ID middleware helper (Gin middleware)
+
+## Metadata
+- **Task ID**: 0.3.4
+- **Title**: Add request ID middleware helper (Gin middleware)
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add request ID middleware helper (Gin middleware)
+
+## Requirements
+- Add request ID middleware helper (Gin middleware)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.3.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/0.4.1-create-githubworkflowsciyml.md b/docs/stories/phase0/0.4.1-create-githubworkflowsciyml.md
new file mode 100644
index 0000000..ba25c3c
--- /dev/null
+++ b/docs/stories/phase0/0.4.1-create-githubworkflowsciyml.md
@@ -0,0 +1,40 @@
+# Task 0.4.1: Create `.github/workflows/ci.yml`:
+
+## Metadata
+- **Task ID**: 0.4.1
+- **Title**: Create `.github/workflows/ci.yml`:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `.github/workflows/ci.yml`:
+
+## Requirements
+- Create `.github/workflows/ci.yml`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/0.4.2-add-makefile-with-common-commands.md b/docs/stories/phase0/0.4.2-add-makefile-with-common-commands.md
new file mode 100644
index 0000000..dca0d59
--- /dev/null
+++ b/docs/stories/phase0/0.4.2-add-makefile-with-common-commands.md
@@ -0,0 +1,40 @@
+# Task 0.4.2: Add `Makefile` with common commands:
+
+## Metadata
+- **Task ID**: 0.4.2
+- **Title**: Add `Makefile` with common commands:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add `Makefile` with common commands:
+
+## Requirements
+- Add `Makefile` with common commands:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/0.5.1-install-gouberorgfx.md b/docs/stories/phase0/0.5.1-install-gouberorgfx.md
new file mode 100644
index 0000000..195db41
--- /dev/null
+++ b/docs/stories/phase0/0.5.1-install-gouberorgfx.md
@@ -0,0 +1,40 @@
+# Task 0.5.1: Install `go.uber.org/fx`
+
+## Metadata
+- **Task ID**: 0.5.1
+- **Title**: Install `go.uber.org/fx`
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `go.uber.org/fx`
+
+## Requirements
+- Install `go.uber.org/fx`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/0.5.2-create-internaldicontainergo.md b/docs/stories/phase0/0.5.2-create-internaldicontainergo.md
new file mode 100644
index 0000000..25b02dd
--- /dev/null
+++ b/docs/stories/phase0/0.5.2-create-internaldicontainergo.md
@@ -0,0 +1,40 @@
+# Task 0.5.2: Create `internal/di/container.go`:
+
+## Metadata
+- **Task ID**: 0.5.2
+- **Title**: Create `internal/di/container.go`:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/di/container.go`:
+
+## Requirements
+- Create `internal/di/container.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/0.5.3-create-cmdplatformmaingo-skeleton.md b/docs/stories/phase0/0.5.3-create-cmdplatformmaingo-skeleton.md
new file mode 100644
index 0000000..d51fc32
--- /dev/null
+++ b/docs/stories/phase0/0.5.3-create-cmdplatformmaingo-skeleton.md
@@ -0,0 +1,40 @@
+# Task 0.5.3: Create `cmd/platform/main.go` skeleton:
+
+## Metadata
+- **Task ID**: 0.5.3
+- **Title**: Create `cmd/platform/main.go` skeleton:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `cmd/platform/main.go` skeleton:
+
+## Requirements
+- Create `cmd/platform/main.go` skeleton:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.5.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase0/README.md b/docs/stories/phase0/README.md
new file mode 100644
index 0000000..3f1d02e
--- /dev/null
+++ b/docs/stories/phase0/README.md
@@ -0,0 +1,47 @@
+# Phase 0: Project Setup & Foundation
+
+## Overview
+Initialize repository structure, set up Go modules and basic tooling, create configuration management foundation, and establish CI/CD skeleton.
+
+## Tasks
+
+### 0.1 Repository Bootstrap
+- [0.1.1 - Initialize Go Module](./0.1.1-initialize-go-module.md)
+- [0.1.2 - Create Directory Structure](./0.1.2-create-directory-structure.md)
+- [0.1.3 - Add Gitignore](./0.1.3-add-gitignore.md)
+- [0.1.4 - Create Initial README](./0.1.4-create-initial-readme.md)
+
+### 0.2 Configuration System
+- [0.2.1 - Install Configuration Dependencies](./0.2.1-install-config-dependencies.md)
+- [0.2.2 - Create Config Interface](./0.2.2-create-config-interface.md)
+- [0.2.3 - Implement Config Loader](./0.2.3-implement-config-loader.md)
+- [0.2.4 - Create Configuration Files](./0.2.4-create-configuration-files.md)
+
+### 0.3 Logging Foundation
+- [0.3.1 - Install Logging Dependencies](./0.3.1-install-logging-dependencies.md)
+- [0.3.2 - Create Logger Interface](./0.3.2-create-logger-interface.md) - Create `pkg/logger/logger.go` interface
+- [0.3.3 - Implement Zap Logger](./0.3.3-implement-zap-logger.md) - Implement `internal/logger/zap_logger.go`
+- [0.3.4 - Add Request ID Middleware](./0.3.4-add-request-id-middleware.md) - Create Gin middleware for request IDs
+
+### 0.4 Basic CI/CD Pipeline
+- [0.4.1 - Create GitHub Actions Workflow](./0.4.1-create-github-actions-workflow.md)
+- [0.4.2 - Create Makefile](./0.4.2-create-makefile.md)
+
+### 0.5 Dependency Injection Setup
+- [0.5.1 - Install FX Dependency](./0.5.1-install-fx-dependency.md)
+- [0.5.2 - Create DI Container](./0.5.2-create-di-container.md)
+- [0.5.3 - Create Main Entry Point](./0.5.3-create-main-entry-point.md)
+
+## Deliverables Checklist
+- [ ] Repository structure in place
+- [ ] Configuration system loads YAML files and env vars
+- [ ] Structured logging works
+- [ ] CI pipeline runs linting and builds binary
+- [ ] Basic DI container initialized
+
+## Acceptance Criteria
+- `go build ./cmd/platform` succeeds
+- `go test ./...` runs (even if tests are empty)
+- CI pipeline passes on empty commit
+- Config loads from `config/default.yaml`
+
diff --git a/docs/stories/phase1/1.1.1-extend-internaldicontainergo.md b/docs/stories/phase1/1.1.1-extend-internaldicontainergo.md
new file mode 100644
index 0000000..49498f9
--- /dev/null
+++ b/docs/stories/phase1/1.1.1-extend-internaldicontainergo.md
@@ -0,0 +1,40 @@
+# Task 1.1.1: Extend `internal/di/container.go`:
+
+## Metadata
+- **Task ID**: 1.1.1
+- **Title**: Extend `internal/di/container.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Extend `internal/di/container.go`:
+
+## Requirements
+- Extend `internal/di/container.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.1.2-create-internaldiprovidersgo.md b/docs/stories/phase1/1.1.2-create-internaldiprovidersgo.md
new file mode 100644
index 0000000..1d1b55e
--- /dev/null
+++ b/docs/stories/phase1/1.1.2-create-internaldiprovidersgo.md
@@ -0,0 +1,40 @@
+# Task 1.1.2: Create `internal/di/providers.go`:
+
+## Metadata
+- **Task ID**: 1.1.2
+- **Title**: Create `internal/di/providers.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/di/providers.go`:
+
+## Requirements
+- Create `internal/di/providers.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.1.3-add-internaldicore_modulego.md b/docs/stories/phase1/1.1.3-add-internaldicore_modulego.md
new file mode 100644
index 0000000..e03e12f
--- /dev/null
+++ b/docs/stories/phase1/1.1.3-add-internaldicore_modulego.md
@@ -0,0 +1,40 @@
+# Task 1.1.3: Add `internal/di/core_module.go`:
+
+## Metadata
+- **Task ID**: 1.1.3
+- **Title**: Add `internal/di/core_module.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add `internal/di/core_module.go`:
+
+## Requirements
+- Add `internal/di/core_module.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.1.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.2.1-install-entgoioentcmdent.md b/docs/stories/phase1/1.2.1-install-entgoioentcmdent.md
new file mode 100644
index 0000000..6eb67b1
--- /dev/null
+++ b/docs/stories/phase1/1.2.1-install-entgoioentcmdent.md
@@ -0,0 +1,40 @@
+# Task 1.2.1: Install `entgo.io/ent/cmd/ent`
+
+## Metadata
+- **Task ID**: 1.2.1
+- **Title**: Install `entgo.io/ent/cmd/ent`
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `entgo.io/ent/cmd/ent`
+
+## Requirements
+- Install `entgo.io/ent/cmd/ent`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.2.2-initialize-ent-schema.md b/docs/stories/phase1/1.2.2-initialize-ent-schema.md
new file mode 100644
index 0000000..831473d
--- /dev/null
+++ b/docs/stories/phase1/1.2.2-initialize-ent-schema.md
@@ -0,0 +1,46 @@
+# Task 1.2.2: Initialize Ent schema:
+
+## Metadata
+- **Task ID**: 1.2.2
+- **Title**: Initialize Ent schema:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Initialize Ent schema:
+
+## Requirements
+- Initialize Ent schema:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.2.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+go run entgo.io/ent/cmd/ent init User Role Permission AuditLog
+```
diff --git a/docs/stories/phase1/1.2.3-define-core-entities-in-internalentschema.md b/docs/stories/phase1/1.2.3-define-core-entities-in-internalentschema.md
new file mode 100644
index 0000000..7b22e11
--- /dev/null
+++ b/docs/stories/phase1/1.2.3-define-core-entities-in-internalentschema.md
@@ -0,0 +1,40 @@
+# Task 1.2.3: Define core entities in `internal/ent/schema/`:
+
+## Metadata
+- **Task ID**: 1.2.3
+- **Title**: Define core entities in `internal/ent/schema/`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Define core entities in `internal/ent/schema/`:
+
+## Requirements
+- Define core entities in `internal/ent/schema/`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.2.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.2.4-generate-ent-code-go-generate-internalent.md b/docs/stories/phase1/1.2.4-generate-ent-code-go-generate-internalent.md
new file mode 100644
index 0000000..8cf4b88
--- /dev/null
+++ b/docs/stories/phase1/1.2.4-generate-ent-code-go-generate-internalent.md
@@ -0,0 +1,40 @@
+# Task 1.2.4: Generate Ent code: `go generate ./internal/ent`
+
+## Metadata
+- **Task ID**: 1.2.4
+- **Title**: Generate Ent code: `go generate ./internal/ent`
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Generate Ent code: `go generate ./internal/ent`
+
+## Requirements
+- Generate Ent code: `go generate ./internal/ent`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.2.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.2.5-create-internalinfradatabaseclientgo.md b/docs/stories/phase1/1.2.5-create-internalinfradatabaseclientgo.md
new file mode 100644
index 0000000..eb448ba
--- /dev/null
+++ b/docs/stories/phase1/1.2.5-create-internalinfradatabaseclientgo.md
@@ -0,0 +1,40 @@
+# Task 1.2.5: Create `internal/infra/database/client.go`:
+
+## Metadata
+- **Task ID**: 1.2.5
+- **Title**: Create `internal/infra/database/client.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/infra/database/client.go`:
+
+## Requirements
+- Create `internal/infra/database/client.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.2.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.2.6-add-database-config-to-configdefaultyaml.md b/docs/stories/phase1/1.2.6-add-database-config-to-configdefaultyaml.md
new file mode 100644
index 0000000..e1e188c
--- /dev/null
+++ b/docs/stories/phase1/1.2.6-add-database-config-to-configdefaultyaml.md
@@ -0,0 +1,40 @@
+# Task 1.2.6: Add database config to `config/default.yaml`
+
+## Metadata
+- **Task ID**: 1.2.6
+- **Title**: Add database config to `config/default.yaml`
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add database config to `config/default.yaml`
+
+## Requirements
+- Add database config to `config/default.yaml`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.2.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.3.1-install-githubcomprometheusclient_golangprometheus.md b/docs/stories/phase1/1.3.1-install-githubcomprometheusclient_golangprometheus.md
new file mode 100644
index 0000000..a5185b6
--- /dev/null
+++ b/docs/stories/phase1/1.3.1-install-githubcomprometheusclient_golangprometheus.md
@@ -0,0 +1,40 @@
+# Task 1.3.1: Install `github.com/prometheus/client_golang/prometheus`
+
+## Metadata
+- **Task ID**: 1.3.1
+- **Title**: Install `github.com/prometheus/client_golang/prometheus`
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/prometheus/client_golang/prometheus`
+
+## Requirements
+- Install `github.com/prometheus/client_golang/prometheus`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.3.2-install-githubcomheptiolabshealthcheck-optional-or.md b/docs/stories/phase1/1.3.2-install-githubcomheptiolabshealthcheck-optional-or.md
new file mode 100644
index 0000000..42e121b
--- /dev/null
+++ b/docs/stories/phase1/1.3.2-install-githubcomheptiolabshealthcheck-optional-or.md
@@ -0,0 +1,40 @@
+# Task 1.3.2: Install `github.com/heptiolabs/healthcheck` (optional, or custom)
+
+## Metadata
+- **Task ID**: 1.3.2
+- **Title**: Install `github.com/heptiolabs/healthcheck` (optional, or custom)
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/heptiolabs/healthcheck` (optional, or custom)
+
+## Requirements
+- Install `github.com/heptiolabs/healthcheck` (optional, or custom)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.3.3-create-pkghealthhealthgo-interface.md b/docs/stories/phase1/1.3.3-create-pkghealthhealthgo-interface.md
new file mode 100644
index 0000000..a891967
--- /dev/null
+++ b/docs/stories/phase1/1.3.3-create-pkghealthhealthgo-interface.md
@@ -0,0 +1,48 @@
+# Task 1.3.3: Create `pkg/health/health.go` interface:
+
+## Metadata
+- **Task ID**: 1.3.3
+- **Title**: Create `pkg/health/health.go` interface:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/health/health.go` interface:
+
+## Requirements
+- Create `pkg/health/health.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type HealthChecker interface {
+      Check(ctx context.Context) error
+  }
+```
diff --git a/docs/stories/phase1/1.3.4-implement-internalhealthregistrygo.md b/docs/stories/phase1/1.3.4-implement-internalhealthregistrygo.md
new file mode 100644
index 0000000..d1a4812
--- /dev/null
+++ b/docs/stories/phase1/1.3.4-implement-internalhealthregistrygo.md
@@ -0,0 +1,40 @@
+# Task 1.3.4: Implement `internal/health/registry.go`:
+
+## Metadata
+- **Task ID**: 1.3.4
+- **Title**: Implement `internal/health/registry.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/health/registry.go`:
+
+## Requirements
+- Implement `internal/health/registry.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.3.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.3.5-create-internalmetricsmetricsgo.md b/docs/stories/phase1/1.3.5-create-internalmetricsmetricsgo.md
new file mode 100644
index 0000000..0c167f1
--- /dev/null
+++ b/docs/stories/phase1/1.3.5-create-internalmetricsmetricsgo.md
@@ -0,0 +1,40 @@
+# Task 1.3.5: Create `internal/metrics/metrics.go`:
+
+## Metadata
+- **Task ID**: 1.3.5
+- **Title**: Create `internal/metrics/metrics.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/metrics/metrics.go`:
+
+## Requirements
+- Create `internal/metrics/metrics.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.3.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.3.6-add-metrics-endpoint-prometheus-format.md b/docs/stories/phase1/1.3.6-add-metrics-endpoint-prometheus-format.md
new file mode 100644
index 0000000..a8c65fb
--- /dev/null
+++ b/docs/stories/phase1/1.3.6-add-metrics-endpoint-prometheus-format.md
@@ -0,0 +1,40 @@
+# Task 1.3.6: Add `/metrics` endpoint (Prometheus format)
+
+## Metadata
+- **Task ID**: 1.3.6
+- **Title**: Add `/metrics` endpoint (Prometheus format)
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add `/metrics` endpoint (Prometheus format)
+
+## Requirements
+- Add `/metrics` endpoint (Prometheus format)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.3.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.3.7-register-endpoints-in-main-http-router.md b/docs/stories/phase1/1.3.7-register-endpoints-in-main-http-router.md
new file mode 100644
index 0000000..afd0055
--- /dev/null
+++ b/docs/stories/phase1/1.3.7-register-endpoints-in-main-http-router.md
@@ -0,0 +1,40 @@
+# Task 1.3.7: Register endpoints in main HTTP router
+
+## Metadata
+- **Task ID**: 1.3.7
+- **Title**: Register endpoints in main HTTP router
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register endpoints in main HTTP router
+
+## Requirements
+- Register endpoints in main HTTP router
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.3.7 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.4.1-create-pkgerrorbuserrorbusgo-interface.md b/docs/stories/phase1/1.4.1-create-pkgerrorbuserrorbusgo-interface.md
new file mode 100644
index 0000000..fcaee40
--- /dev/null
+++ b/docs/stories/phase1/1.4.1-create-pkgerrorbuserrorbusgo-interface.md
@@ -0,0 +1,48 @@
+# Task 1.4.1: Create `pkg/errorbus/errorbus.go` interface:
+
+## Metadata
+- **Task ID**: 1.4.1
+- **Title**: Create `pkg/errorbus/errorbus.go` interface:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/errorbus/errorbus.go` interface:
+
+## Requirements
+- Create `pkg/errorbus/errorbus.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type ErrorPublisher interface {
+      Publish(err error)
+  }
+```
diff --git a/docs/stories/phase1/1.4.2-implement-internalerrorbuschannel_busgo.md b/docs/stories/phase1/1.4.2-implement-internalerrorbuschannel_busgo.md
new file mode 100644
index 0000000..b5f0e47
--- /dev/null
+++ b/docs/stories/phase1/1.4.2-implement-internalerrorbuschannel_busgo.md
@@ -0,0 +1,40 @@
+# Task 1.4.2: Implement `internal/errorbus/channel_bus.go`:
+
+## Metadata
+- **Task ID**: 1.4.2
+- **Title**: Implement `internal/errorbus/channel_bus.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/errorbus/channel_bus.go`:
+
+## Requirements
+- Implement `internal/errorbus/channel_bus.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.4.3-add-panic-recovery-middleware-that-publishes-to-er.md b/docs/stories/phase1/1.4.3-add-panic-recovery-middleware-that-publishes-to-er.md
new file mode 100644
index 0000000..9edce33
--- /dev/null
+++ b/docs/stories/phase1/1.4.3-add-panic-recovery-middleware-that-publishes-to-er.md
@@ -0,0 +1,40 @@
+# Task 1.4.3: Add panic recovery middleware that publishes to error bus
+
+## Metadata
+- **Task ID**: 1.4.3
+- **Title**: Add panic recovery middleware that publishes to error bus
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add panic recovery middleware that publishes to error bus
+
+## Requirements
+- Add panic recovery middleware that publishes to error bus
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.4.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.4.4-register-error-bus-in-di-container.md b/docs/stories/phase1/1.4.4-register-error-bus-in-di-container.md
new file mode 100644
index 0000000..560ff6b
--- /dev/null
+++ b/docs/stories/phase1/1.4.4-register-error-bus-in-di-container.md
@@ -0,0 +1,40 @@
+# Task 1.4.4: Register error bus in DI container
+
+## Metadata
+- **Task ID**: 1.4.4
+- **Title**: Register error bus in DI container
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register error bus in DI container
+
+## Requirements
+- Register error bus in DI container
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.4.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.5.1-install-githubcomgin-gonicgin.md b/docs/stories/phase1/1.5.1-install-githubcomgin-gonicgin.md
new file mode 100644
index 0000000..389c589
--- /dev/null
+++ b/docs/stories/phase1/1.5.1-install-githubcomgin-gonicgin.md
@@ -0,0 +1,40 @@
+# Task 1.5.1: Install `github.com/gin-gonic/gin`
+
+## Metadata
+- **Task ID**: 1.5.1
+- **Title**: Install `github.com/gin-gonic/gin`
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/gin-gonic/gin`
+
+## Requirements
+- Install `github.com/gin-gonic/gin`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.5.2-create-internalserverservergo.md b/docs/stories/phase1/1.5.2-create-internalserverservergo.md
new file mode 100644
index 0000000..d959908
--- /dev/null
+++ b/docs/stories/phase1/1.5.2-create-internalserverservergo.md
@@ -0,0 +1,40 @@
+# Task 1.5.2: Create `internal/server/server.go`:
+
+## Metadata
+- **Task ID**: 1.5.2
+- **Title**: Create `internal/server/server.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/server/server.go`:
+
+## Requirements
+- Create `internal/server/server.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.5.3-wire-http-server-into-fx-lifecycle.md b/docs/stories/phase1/1.5.3-wire-http-server-into-fx-lifecycle.md
new file mode 100644
index 0000000..35c3183
--- /dev/null
+++ b/docs/stories/phase1/1.5.3-wire-http-server-into-fx-lifecycle.md
@@ -0,0 +1,40 @@
+# Task 1.5.3: Wire HTTP server into fx lifecycle:
+
+## Metadata
+- **Task ID**: 1.5.3
+- **Title**: Wire HTTP server into fx lifecycle:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Wire HTTP server into fx lifecycle:
+
+## Requirements
+- Wire HTTP server into fx lifecycle:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.5.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.5.4-update-cmdplatformmaingo-to-use-fx-lifecycle.md b/docs/stories/phase1/1.5.4-update-cmdplatformmaingo-to-use-fx-lifecycle.md
new file mode 100644
index 0000000..b2d5634
--- /dev/null
+++ b/docs/stories/phase1/1.5.4-update-cmdplatformmaingo-to-use-fx-lifecycle.md
@@ -0,0 +1,40 @@
+# Task 1.5.4: Update `cmd/platform/main.go` to use fx lifecycle
+
+## Metadata
+- **Task ID**: 1.5.4
+- **Title**: Update `cmd/platform/main.go` to use fx lifecycle
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Update `cmd/platform/main.go` to use fx lifecycle
+
+## Requirements
+- Update `cmd/platform/main.go` to use fx lifecycle
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.5.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.6.1-install-opentelemetry-packages.md b/docs/stories/phase1/1.6.1-install-opentelemetry-packages.md
new file mode 100644
index 0000000..7212d79
--- /dev/null
+++ b/docs/stories/phase1/1.6.1-install-opentelemetry-packages.md
@@ -0,0 +1,40 @@
+# Task 1.6.1: Install OpenTelemetry packages:
+
+## Metadata
+- **Task ID**: 1.6.1
+- **Title**: Install OpenTelemetry packages:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install OpenTelemetry packages:
+
+## Requirements
+- Install OpenTelemetry packages:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.6.2-create-internalobservabilitytracergo.md b/docs/stories/phase1/1.6.2-create-internalobservabilitytracergo.md
new file mode 100644
index 0000000..d215973
--- /dev/null
+++ b/docs/stories/phase1/1.6.2-create-internalobservabilitytracergo.md
@@ -0,0 +1,40 @@
+# Task 1.6.2: Create `internal/observability/tracer.go`:
+
+## Metadata
+- **Task ID**: 1.6.2
+- **Title**: Create `internal/observability/tracer.go`:
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/observability/tracer.go`:
+
+## Requirements
+- Create `internal/observability/tracer.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.6.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.6.3-add-http-instrumentation-middleware.md b/docs/stories/phase1/1.6.3-add-http-instrumentation-middleware.md
new file mode 100644
index 0000000..43b9284
--- /dev/null
+++ b/docs/stories/phase1/1.6.3-add-http-instrumentation-middleware.md
@@ -0,0 +1,40 @@
+# Task 1.6.3: Add HTTP instrumentation middleware
+
+## Metadata
+- **Task ID**: 1.6.3
+- **Title**: Add HTTP instrumentation middleware
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add HTTP instrumentation middleware
+
+## Requirements
+- Add HTTP instrumentation middleware
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.6.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase1/1.6.4-add-trace-context-propagation-to-requests.md b/docs/stories/phase1/1.6.4-add-trace-context-propagation-to-requests.md
new file mode 100644
index 0000000..ef3abca
--- /dev/null
+++ b/docs/stories/phase1/1.6.4-add-trace-context-propagation-to-requests.md
@@ -0,0 +1,40 @@
+# Task 1.6.4: Add trace context propagation to requests
+
+## Metadata
+- **Task ID**: 1.6.4
+- **Title**: Add trace context propagation to requests
+- **Phase**: 1 - Core Kernel & Infrastructure
+- **Section**: 1.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add trace context propagation to requests
+
+## Requirements
+- Add trace context propagation to requests
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 1.6.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.1.1-install-githubcomgolang-jwtjwtv5.md b/docs/stories/phase2/2.1.1-install-githubcomgolang-jwtjwtv5.md
new file mode 100644
index 0000000..dd056bd
--- /dev/null
+++ b/docs/stories/phase2/2.1.1-install-githubcomgolang-jwtjwtv5.md
@@ -0,0 +1,40 @@
+# Task 2.1.1: Install `github.com/golang-jwt/jwt/v5`
+
+## Metadata
+- **Task ID**: 2.1.1
+- **Title**: Install `github.com/golang-jwt/jwt/v5`
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/golang-jwt/jwt/v5`
+
+## Requirements
+- Install `github.com/golang-jwt/jwt/v5`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.1.2-create-pkgauthauthgo-interfaces.md b/docs/stories/phase2/2.1.2-create-pkgauthauthgo-interfaces.md
new file mode 100644
index 0000000..d73c12f
--- /dev/null
+++ b/docs/stories/phase2/2.1.2-create-pkgauthauthgo-interfaces.md
@@ -0,0 +1,56 @@
+# Task 2.1.2: Create `pkg/auth/auth.go` interfaces:
+
+## Metadata
+- **Task ID**: 2.1.2
+- **Title**: Create `pkg/auth/auth.go` interfaces:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/auth/auth.go` interfaces:
+
+## Requirements
+- Create `pkg/auth/auth.go` interfaces:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Authenticator interface {
+      GenerateToken(userID string, roles []string, tenantID string) (string, error)
+      VerifyToken(token string) (*TokenClaims, error)
+  }
+  
+  type TokenClaims struct {
+      UserID   string
+      Roles    []string
+      TenantID string
+      ExpiresAt time.Time
+  }
+```
diff --git a/docs/stories/phase2/2.1.3-implement-internalauthjwt_authgo.md b/docs/stories/phase2/2.1.3-implement-internalauthjwt_authgo.md
new file mode 100644
index 0000000..4d4f688
--- /dev/null
+++ b/docs/stories/phase2/2.1.3-implement-internalauthjwt_authgo.md
@@ -0,0 +1,40 @@
+# Task 2.1.3: Implement `internal/auth/jwt_auth.go`:
+
+## Metadata
+- **Task ID**: 2.1.3
+- **Title**: Implement `internal/auth/jwt_auth.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/auth/jwt_auth.go`:
+
+## Requirements
+- Implement `internal/auth/jwt_auth.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.1.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.1.4-create-internalauthmiddlewarego.md b/docs/stories/phase2/2.1.4-create-internalauthmiddlewarego.md
new file mode 100644
index 0000000..01f32c2
--- /dev/null
+++ b/docs/stories/phase2/2.1.4-create-internalauthmiddlewarego.md
@@ -0,0 +1,40 @@
+# Task 2.1.4: Create `internal/auth/middleware.go`:
+
+## Metadata
+- **Task ID**: 2.1.4
+- **Title**: Create `internal/auth/middleware.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/auth/middleware.go`:
+
+## Requirements
+- Create `internal/auth/middleware.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.1.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.1.5-add-login-endpoint-post-apiv1authlogin.md b/docs/stories/phase2/2.1.5-add-login-endpoint-post-apiv1authlogin.md
new file mode 100644
index 0000000..8007e82
--- /dev/null
+++ b/docs/stories/phase2/2.1.5-add-login-endpoint-post-apiv1authlogin.md
@@ -0,0 +1,40 @@
+# Task 2.1.5: Add login endpoint: `POST /api/v1/auth/login`
+
+## Metadata
+- **Task ID**: 2.1.5
+- **Title**: Add login endpoint: `POST /api/v1/auth/login`
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add login endpoint: `POST /api/v1/auth/login`
+
+## Requirements
+- Add login endpoint: `POST /api/v1/auth/login`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.1.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.1.6-add-refresh-endpoint-post-apiv1authrefresh.md b/docs/stories/phase2/2.1.6-add-refresh-endpoint-post-apiv1authrefresh.md
new file mode 100644
index 0000000..673eb3a
--- /dev/null
+++ b/docs/stories/phase2/2.1.6-add-refresh-endpoint-post-apiv1authrefresh.md
@@ -0,0 +1,40 @@
+# Task 2.1.6: Add refresh endpoint: `POST /api/v1/auth/refresh`
+
+## Metadata
+- **Task ID**: 2.1.6
+- **Title**: Add refresh endpoint: `POST /api/v1/auth/refresh`
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add refresh endpoint: `POST /api/v1/auth/refresh`
+
+## Requirements
+- Add refresh endpoint: `POST /api/v1/auth/refresh`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.1.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.2.1-create-pkgidentityidentitygo-interfaces.md b/docs/stories/phase2/2.2.1-create-pkgidentityidentitygo-interfaces.md
new file mode 100644
index 0000000..7203166
--- /dev/null
+++ b/docs/stories/phase2/2.2.1-create-pkgidentityidentitygo-interfaces.md
@@ -0,0 +1,59 @@
+# Task 2.2.1: Create `pkg/identity/identity.go` interfaces:
+
+## Metadata
+- **Task ID**: 2.2.1
+- **Title**: Create `pkg/identity/identity.go` interfaces:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/identity/identity.go` interfaces:
+
+## Requirements
+- Create `pkg/identity/identity.go` interfaces:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type UserRepository interface {
+      FindByID(ctx context.Context, id string) (*User, error)
+      FindByEmail(ctx context.Context, email string) (*User, error)
+      Create(ctx context.Context, u *User) error
+      Update(ctx context.Context, u *User) error
+      Delete(ctx context.Context, id string) error
+  }
+  
+  type UserService interface {
+      Register(ctx context.Context, email, password string) (*User, error)
+      VerifyEmail(ctx context.Context, token string) error
+      ResetPassword(ctx context.Context, email string) error
+      ChangePassword(ctx context.Context, userID, oldPassword, newPassword string) error
+  }
+```
diff --git a/docs/stories/phase2/2.2.2-implement-internalidentityuser_repogo-using-ent.md b/docs/stories/phase2/2.2.2-implement-internalidentityuser_repogo-using-ent.md
new file mode 100644
index 0000000..60c9581
--- /dev/null
+++ b/docs/stories/phase2/2.2.2-implement-internalidentityuser_repogo-using-ent.md
@@ -0,0 +1,40 @@
+# Task 2.2.2: Implement `internal/identity/user_repo.go` using Ent:
+
+## Metadata
+- **Task ID**: 2.2.2
+- **Title**: Implement `internal/identity/user_repo.go` using Ent:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/identity/user_repo.go` using Ent:
+
+## Requirements
+- Implement `internal/identity/user_repo.go` using Ent:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.2.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.2.3-implement-internalidentityuser_servicego.md b/docs/stories/phase2/2.2.3-implement-internalidentityuser_servicego.md
new file mode 100644
index 0000000..5019ca7
--- /dev/null
+++ b/docs/stories/phase2/2.2.3-implement-internalidentityuser_servicego.md
@@ -0,0 +1,40 @@
+# Task 2.2.3: Implement `internal/identity/user_service.go`:
+
+## Metadata
+- **Task ID**: 2.2.3
+- **Title**: Implement `internal/identity/user_service.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/identity/user_service.go`:
+
+## Requirements
+- Implement `internal/identity/user_service.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.2.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.2.4-add-endpoints.md b/docs/stories/phase2/2.2.4-add-endpoints.md
new file mode 100644
index 0000000..9d5a0a4
--- /dev/null
+++ b/docs/stories/phase2/2.2.4-add-endpoints.md
@@ -0,0 +1,40 @@
+# Task 2.2.4: Add endpoints:
+
+## Metadata
+- **Task ID**: 2.2.4
+- **Title**: Add endpoints:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add endpoints:
+
+## Requirements
+- Add endpoints:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.2.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.3.1-create-pkgpermpermgo.md b/docs/stories/phase2/2.3.1-create-pkgpermpermgo.md
new file mode 100644
index 0000000..c384067
--- /dev/null
+++ b/docs/stories/phase2/2.3.1-create-pkgpermpermgo.md
@@ -0,0 +1,59 @@
+# Task 2.3.1: Create `pkg/perm/perm.go`:
+
+## Metadata
+- **Task ID**: 2.3.1
+- **Title**: Create `pkg/perm/perm.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/perm/perm.go`:
+
+## Requirements
+- Create `pkg/perm/perm.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Permission string
+  
+  // Core permissions
+  var (
+      SystemHealthCheck Permission = "system.health.check"
+      UserCreate        Permission = "user.create"
+      UserRead          Permission = "user.read"
+      UserUpdate        Permission = "user.update"
+      UserDelete        Permission = "user.delete"
+      RoleCreate        Permission = "role.create"
+      RoleRead          Permission = "role.read"
+      RoleUpdate        Permission = "role.update"
+      RoleDelete        Permission = "role.delete"
+  )
+```
diff --git a/docs/stories/phase2/2.3.2-create-pkgpermresolvergo-interface.md b/docs/stories/phase2/2.3.2-create-pkgpermresolvergo-interface.md
new file mode 100644
index 0000000..13e7d25
--- /dev/null
+++ b/docs/stories/phase2/2.3.2-create-pkgpermresolvergo-interface.md
@@ -0,0 +1,49 @@
+# Task 2.3.2: Create `pkg/perm/resolver.go` interface:
+
+## Metadata
+- **Task ID**: 2.3.2
+- **Title**: Create `pkg/perm/resolver.go` interface:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/perm/resolver.go` interface:
+
+## Requirements
+- Create `pkg/perm/resolver.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type PermissionResolver interface {
+      HasPermission(ctx context.Context, userID string, perm Permission) (bool, error)
+      GetUserPermissions(ctx context.Context, userID string) ([]Permission, error)
+  }
+```
diff --git a/docs/stories/phase2/2.3.3-implement-internalpermin_memory_resolvergo.md b/docs/stories/phase2/2.3.3-implement-internalpermin_memory_resolvergo.md
new file mode 100644
index 0000000..e9e9477
--- /dev/null
+++ b/docs/stories/phase2/2.3.3-implement-internalpermin_memory_resolvergo.md
@@ -0,0 +1,40 @@
+# Task 2.3.3: Implement `internal/perm/in_memory_resolver.go`:
+
+## Metadata
+- **Task ID**: 2.3.3
+- **Title**: Implement `internal/perm/in_memory_resolver.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/perm/in_memory_resolver.go`:
+
+## Requirements
+- Implement `internal/perm/in_memory_resolver.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.3.4-create-pkgauthauthzgo-interface.md b/docs/stories/phase2/2.3.4-create-pkgauthauthzgo-interface.md
new file mode 100644
index 0000000..6bf7ad1
--- /dev/null
+++ b/docs/stories/phase2/2.3.4-create-pkgauthauthzgo-interface.md
@@ -0,0 +1,48 @@
+# Task 2.3.4: Create `pkg/auth/authz.go` interface:
+
+## Metadata
+- **Task ID**: 2.3.4
+- **Title**: Create `pkg/auth/authz.go` interface:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/auth/authz.go` interface:
+
+## Requirements
+- Create `pkg/auth/authz.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.3.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Authorizer interface {
+      Authorize(ctx context.Context, perm Permission) error
+  }
+```
diff --git a/docs/stories/phase2/2.3.5-implement-internalauthrbac_authorizergo.md b/docs/stories/phase2/2.3.5-implement-internalauthrbac_authorizergo.md
new file mode 100644
index 0000000..d002632
--- /dev/null
+++ b/docs/stories/phase2/2.3.5-implement-internalauthrbac_authorizergo.md
@@ -0,0 +1,40 @@
+# Task 2.3.5: Implement `internal/auth/rbac_authorizer.go`:
+
+## Metadata
+- **Task ID**: 2.3.5
+- **Title**: Implement `internal/auth/rbac_authorizer.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/auth/rbac_authorizer.go`:
+
+## Requirements
+- Implement `internal/auth/rbac_authorizer.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.3.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.3.6-create-authorization-middleware.md b/docs/stories/phase2/2.3.6-create-authorization-middleware.md
new file mode 100644
index 0000000..b3fece4
--- /dev/null
+++ b/docs/stories/phase2/2.3.6-create-authorization-middleware.md
@@ -0,0 +1,40 @@
+# Task 2.3.6: Create authorization middleware:
+
+## Metadata
+- **Task ID**: 2.3.6
+- **Title**: Create authorization middleware:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create authorization middleware:
+
+## Requirements
+- Create authorization middleware:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.3.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.4.1-create-internalidentityrole_repogo.md b/docs/stories/phase2/2.4.1-create-internalidentityrole_repogo.md
new file mode 100644
index 0000000..d2a8aa9
--- /dev/null
+++ b/docs/stories/phase2/2.4.1-create-internalidentityrole_repogo.md
@@ -0,0 +1,40 @@
+# Task 2.4.1: Create `internal/identity/role_repo.go`:
+
+## Metadata
+- **Task ID**: 2.4.1
+- **Title**: Create `internal/identity/role_repo.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/identity/role_repo.go`:
+
+## Requirements
+- Create `internal/identity/role_repo.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.4.2-add-endpoints.md b/docs/stories/phase2/2.4.2-add-endpoints.md
new file mode 100644
index 0000000..ab7c3f2
--- /dev/null
+++ b/docs/stories/phase2/2.4.2-add-endpoints.md
@@ -0,0 +1,40 @@
+# Task 2.4.2: Add endpoints:
+
+## Metadata
+- **Task ID**: 2.4.2
+- **Title**: Add endpoints:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add endpoints:
+
+## Requirements
+- Add endpoints:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.5.1-create-pkgauditauditgo-interface.md b/docs/stories/phase2/2.5.1-create-pkgauditauditgo-interface.md
new file mode 100644
index 0000000..201bf9d
--- /dev/null
+++ b/docs/stories/phase2/2.5.1-create-pkgauditauditgo-interface.md
@@ -0,0 +1,55 @@
+# Task 2.5.1: Create `pkg/audit/audit.go` interface:
+
+## Metadata
+- **Task ID**: 2.5.1
+- **Title**: Create `pkg/audit/audit.go` interface:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/audit/audit.go` interface:
+
+## Requirements
+- Create `pkg/audit/audit.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Auditor interface {
+      Record(ctx context.Context, act AuditAction) error
+  }
+  
+  type AuditAction struct {
+      ActorID  string
+      Action   string
+      TargetID string
+      Metadata map[string]any
+  }
+```
diff --git a/docs/stories/phase2/2.5.2-implement-internalauditent_auditorgo.md b/docs/stories/phase2/2.5.2-implement-internalauditent_auditorgo.md
new file mode 100644
index 0000000..7dbfc47
--- /dev/null
+++ b/docs/stories/phase2/2.5.2-implement-internalauditent_auditorgo.md
@@ -0,0 +1,40 @@
+# Task 2.5.2: Implement `internal/audit/ent_auditor.go`:
+
+## Metadata
+- **Task ID**: 2.5.2
+- **Title**: Implement `internal/audit/ent_auditor.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/audit/ent_auditor.go`:
+
+## Requirements
+- Implement `internal/audit/ent_auditor.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.5.3-add-audit-middleware.md b/docs/stories/phase2/2.5.3-add-audit-middleware.md
new file mode 100644
index 0000000..63b7541
--- /dev/null
+++ b/docs/stories/phase2/2.5.3-add-audit-middleware.md
@@ -0,0 +1,40 @@
+# Task 2.5.3: Add audit middleware:
+
+## Metadata
+- **Task ID**: 2.5.3
+- **Title**: Add audit middleware:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add audit middleware:
+
+## Requirements
+- Add audit middleware:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.5.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.5.4-integrate-with-auth-endpoints.md b/docs/stories/phase2/2.5.4-integrate-with-auth-endpoints.md
new file mode 100644
index 0000000..f9b0850
--- /dev/null
+++ b/docs/stories/phase2/2.5.4-integrate-with-auth-endpoints.md
@@ -0,0 +1,40 @@
+# Task 2.5.4: Integrate with auth endpoints:
+
+## Metadata
+- **Task ID**: 2.5.4
+- **Title**: Integrate with auth endpoints:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Integrate with auth endpoints:
+
+## Requirements
+- Integrate with auth endpoints:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.5.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase2/2.6.1-create-internalseedseedgo.md b/docs/stories/phase2/2.6.1-create-internalseedseedgo.md
new file mode 100644
index 0000000..aedaf74
--- /dev/null
+++ b/docs/stories/phase2/2.6.1-create-internalseedseedgo.md
@@ -0,0 +1,40 @@
+# Task 2.6.1: Create `internal/seed/seed.go`:
+
+## Metadata
+- **Task ID**: 2.6.1
+- **Title**: Create `internal/seed/seed.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/seed/seed.go`:
+
+## Requirements
+- Create `internal/seed/seed.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.1.1-create-pkgmodulemodulego.md b/docs/stories/phase3/3.1.1-create-pkgmodulemodulego.md
new file mode 100644
index 0000000..e3862a7
--- /dev/null
+++ b/docs/stories/phase3/3.1.1-create-pkgmodulemodulego.md
@@ -0,0 +1,52 @@
+# Task 3.1.1: Create `pkg/module/module.go`:
+
+## Metadata
+- **Task ID**: 3.1.1
+- **Title**: Create `pkg/module/module.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/module/module.go`:
+
+## Requirements
+- Create `pkg/module/module.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type IModule interface {
+      Name() string
+      Version() string
+      Dependencies() []string
+      Init() fx.Option
+      Migrations() []func(*ent.Client) error
+  }
+```
diff --git a/docs/stories/phase3/3.1.2-create-pkgmodulemanifestgo.md b/docs/stories/phase3/3.1.2-create-pkgmodulemanifestgo.md
new file mode 100644
index 0000000..1d011b6
--- /dev/null
+++ b/docs/stories/phase3/3.1.2-create-pkgmodulemanifestgo.md
@@ -0,0 +1,52 @@
+# Task 3.1.2: Create `pkg/module/manifest.go`:
+
+## Metadata
+- **Task ID**: 3.1.2
+- **Title**: Create `pkg/module/manifest.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/module/manifest.go`:
+
+## Requirements
+- Create `pkg/module/manifest.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Manifest struct {
+      Name         string
+      Version      string
+      Dependencies []string
+      Permissions  []string
+      Routes       []Route
+  }
+```
diff --git a/docs/stories/phase3/3.1.3-define-moduleyaml-schema-used-for-code-generation.md b/docs/stories/phase3/3.1.3-define-moduleyaml-schema-used-for-code-generation.md
new file mode 100644
index 0000000..a56ba4b
--- /dev/null
+++ b/docs/stories/phase3/3.1.3-define-moduleyaml-schema-used-for-code-generation.md
@@ -0,0 +1,40 @@
+# Task 3.1.3: Define `module.yaml` schema (used for code generation)
+
+## Metadata
+- **Task ID**: 3.1.3
+- **Title**: Define `module.yaml` schema (used for code generation)
+- **Phase**: 3 - Module Framework
+- **Section**: 3.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Define `module.yaml` schema (used for code generation)
+
+## Requirements
+- Define `module.yaml` schema (used for code generation)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.1.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.2.1-create-internalregistryregistrygo.md b/docs/stories/phase3/3.2.1-create-internalregistryregistrygo.md
new file mode 100644
index 0000000..e847a2c
--- /dev/null
+++ b/docs/stories/phase3/3.2.1-create-internalregistryregistrygo.md
@@ -0,0 +1,40 @@
+# Task 3.2.1: Create `internal/registry/registry.go`:
+
+## Metadata
+- **Task ID**: 3.2.1
+- **Title**: Create `internal/registry/registry.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/registry/registry.go`:
+
+## Requirements
+- Create `internal/registry/registry.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.2.2-add-registration-validation.md b/docs/stories/phase3/3.2.2-add-registration-validation.md
new file mode 100644
index 0000000..da58b03
--- /dev/null
+++ b/docs/stories/phase3/3.2.2-add-registration-validation.md
@@ -0,0 +1,40 @@
+# Task 3.2.2: Add registration validation:
+
+## Metadata
+- **Task ID**: 3.2.2
+- **Title**: Add registration validation:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add registration validation:
+
+## Requirements
+- Add registration validation:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.2.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.3.1-create-scriptsgenerate-permissionsgo.md b/docs/stories/phase3/3.3.1-create-scriptsgenerate-permissionsgo.md
new file mode 100644
index 0000000..23eb123
--- /dev/null
+++ b/docs/stories/phase3/3.3.1-create-scriptsgenerate-permissionsgo.md
@@ -0,0 +1,40 @@
+# Task 3.3.1: Create `scripts/generate-permissions.go`:
+
+## Metadata
+- **Task ID**: 3.3.1
+- **Title**: Create `scripts/generate-permissions.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `scripts/generate-permissions.go`:
+
+## Requirements
+- Create `scripts/generate-permissions.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.3.2-add-gogenerate-directive-to-pkgpermpermgo.md b/docs/stories/phase3/3.3.2-add-gogenerate-directive-to-pkgpermpermgo.md
new file mode 100644
index 0000000..70ec12a
--- /dev/null
+++ b/docs/stories/phase3/3.3.2-add-gogenerate-directive-to-pkgpermpermgo.md
@@ -0,0 +1,40 @@
+# Task 3.3.2: Add `//go:generate` directive to `pkg/perm/perm.go`
+
+## Metadata
+- **Task ID**: 3.3.2
+- **Title**: Add `//go:generate` directive to `pkg/perm/perm.go`
+- **Phase**: 3 - Module Framework
+- **Section**: 3.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add `//go:generate` directive to `pkg/perm/perm.go`
+
+## Requirements
+- Add `//go:generate` directive to `pkg/perm/perm.go`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.3.3-update-makefile-with-make-generate-command.md b/docs/stories/phase3/3.3.3-update-makefile-with-make-generate-command.md
new file mode 100644
index 0000000..77de86e
--- /dev/null
+++ b/docs/stories/phase3/3.3.3-update-makefile-with-make-generate-command.md
@@ -0,0 +1,40 @@
+# Task 3.3.3: Update `Makefile` with `make generate` command
+
+## Metadata
+- **Task ID**: 3.3.3
+- **Title**: Update `Makefile` with `make generate` command
+- **Phase**: 3 - Module Framework
+- **Section**: 3.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Update `Makefile` with `make generate` command
+
+## Requirements
+- Update `Makefile` with `make generate` command
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.4.1-create-internalpluginloaderloadergo.md b/docs/stories/phase3/3.4.1-create-internalpluginloaderloadergo.md
new file mode 100644
index 0000000..8226f77
--- /dev/null
+++ b/docs/stories/phase3/3.4.1-create-internalpluginloaderloadergo.md
@@ -0,0 +1,40 @@
+# Task 3.4.1: Create `internal/pluginloader/loader.go`:
+
+## Metadata
+- **Task ID**: 3.4.1
+- **Title**: Create `internal/pluginloader/loader.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/pluginloader/loader.go`:
+
+## Requirements
+- Create `internal/pluginloader/loader.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.4.2-implement-internalpluginloaderstatic_loadergo.md b/docs/stories/phase3/3.4.2-implement-internalpluginloaderstatic_loadergo.md
new file mode 100644
index 0000000..fbdd6ca
--- /dev/null
+++ b/docs/stories/phase3/3.4.2-implement-internalpluginloaderstatic_loadergo.md
@@ -0,0 +1,40 @@
+# Task 3.4.2: Implement `internal/pluginloader/static_loader.go`:
+
+## Metadata
+- **Task ID**: 3.4.2
+- **Title**: Implement `internal/pluginloader/static_loader.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/pluginloader/static_loader.go`:
+
+## Requirements
+- Implement `internal/pluginloader/static_loader.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.4.3-implement-internalpluginloaderplugin_loadergo-opti.md b/docs/stories/phase3/3.4.3-implement-internalpluginloaderplugin_loadergo-opti.md
new file mode 100644
index 0000000..9fa5b64
--- /dev/null
+++ b/docs/stories/phase3/3.4.3-implement-internalpluginloaderplugin_loadergo-opti.md
@@ -0,0 +1,40 @@
+# Task 3.4.3: Implement `internal/pluginloader/plugin_loader.go` (optional):
+
+## Metadata
+- **Task ID**: 3.4.3
+- **Title**: Implement `internal/pluginloader/plugin_loader.go` (optional):
+- **Phase**: 3 - Module Framework
+- **Section**: 3.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/pluginloader/plugin_loader.go` (optional):
+
+## Requirements
+- Implement `internal/pluginloader/plugin_loader.go` (optional):
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.4.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.5.1-create-internalmoduleinitializergo.md b/docs/stories/phase3/3.5.1-create-internalmoduleinitializergo.md
new file mode 100644
index 0000000..72fda56
--- /dev/null
+++ b/docs/stories/phase3/3.5.1-create-internalmoduleinitializergo.md
@@ -0,0 +1,40 @@
+# Task 3.5.1: Create `internal/module/initializer.go`:
+
+## Metadata
+- **Task ID**: 3.5.1
+- **Title**: Create `internal/module/initializer.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/module/initializer.go`:
+
+## Requirements
+- Create `internal/module/initializer.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.5.2-run-migrations.md b/docs/stories/phase3/3.5.2-run-migrations.md
new file mode 100644
index 0000000..cf7a57c
--- /dev/null
+++ b/docs/stories/phase3/3.5.2-run-migrations.md
@@ -0,0 +1,40 @@
+# Task 3.5.2: Run migrations:
+
+## Metadata
+- **Task ID**: 3.5.2
+- **Title**: Run migrations:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Run migrations:
+
+## Requirements
+- Run migrations:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.6.1-extend-pkgmodulemodulego.md b/docs/stories/phase3/3.6.1-extend-pkgmodulemodulego.md
new file mode 100644
index 0000000..ac1c5cf
--- /dev/null
+++ b/docs/stories/phase3/3.6.1-extend-pkgmodulemodulego.md
@@ -0,0 +1,50 @@
+# Task 3.6.1: Extend `pkg/module/module.go`:
+
+## Metadata
+- **Task ID**: 3.6.1
+- **Title**: Extend `pkg/module/module.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Extend `pkg/module/module.go`:
+
+## Requirements
+- Extend `pkg/module/module.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type IModule interface {
+      // ... existing methods
+      OnStart(ctx context.Context) error  // Optional
+      OnStop(ctx context.Context) error  // Optional
+  }
+```
diff --git a/docs/stories/phase3/3.6.2-integrate-with-fxlifecycle.md b/docs/stories/phase3/3.6.2-integrate-with-fxlifecycle.md
new file mode 100644
index 0000000..195ef56
--- /dev/null
+++ b/docs/stories/phase3/3.6.2-integrate-with-fxlifecycle.md
@@ -0,0 +1,40 @@
+# Task 3.6.2: Integrate with fx.Lifecycle:
+
+## Metadata
+- **Task ID**: 3.6.2
+- **Title**: Integrate with fx.Lifecycle:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Integrate with fx.Lifecycle:
+
+## Requirements
+- Integrate with fx.Lifecycle:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.6.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.7.1-create-cmdplatformctlmaingo.md b/docs/stories/phase3/3.7.1-create-cmdplatformctlmaingo.md
new file mode 100644
index 0000000..d22f317
--- /dev/null
+++ b/docs/stories/phase3/3.7.1-create-cmdplatformctlmaingo.md
@@ -0,0 +1,40 @@
+# Task 3.7.1: Create `cmd/platformctl/main.go`:
+
+## Metadata
+- **Task ID**: 3.7.1
+- **Title**: Create `cmd/platformctl/main.go`:
+- **Phase**: 3 - Module Framework
+- **Section**: 3.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `cmd/platformctl/main.go`:
+
+## Requirements
+- Create `cmd/platformctl/main.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.7.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase3/3.7.2-add-to-makefile-make-install-cli.md b/docs/stories/phase3/3.7.2-add-to-makefile-make-install-cli.md
new file mode 100644
index 0000000..cd55ee9
--- /dev/null
+++ b/docs/stories/phase3/3.7.2-add-to-makefile-make-install-cli.md
@@ -0,0 +1,40 @@
+# Task 3.7.2: Add to `Makefile`: `make install-cli`
+
+## Metadata
+- **Task ID**: 3.7.2
+- **Title**: Add to `Makefile`: `make install-cli`
+- **Phase**: 3 - Module Framework
+- **Section**: 3.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add to `Makefile`: `make install-cli`
+
+## Requirements
+- Add to `Makefile`: `make install-cli`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 3.7.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.1.1-create-modulesblog-directory.md b/docs/stories/phase4/4.1.1-create-modulesblog-directory.md
new file mode 100644
index 0000000..14985e1
--- /dev/null
+++ b/docs/stories/phase4/4.1.1-create-modulesblog-directory.md
@@ -0,0 +1,58 @@
+# Task 4.1.1: Create `modules/blog/` directory:
+
+## Metadata
+- **Task ID**: 4.1.1
+- **Title**: Create `modules/blog/` directory:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/blog/` directory:
+
+## Requirements
+- Create `modules/blog/` directory:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+modules/blog/
+  ├── go.mod
+  ├── module.yaml
+  ├── internal/
+  │   ├── api/
+  │   │   └── handler.go
+  │   ├── domain/
+  │   │   ├── post.go
+  │   │   └── post_repo.go
+  │   └── service/
+  │       └── post_service.go
+  └── pkg/
+      └── module.go
+```
diff --git a/docs/stories/phase4/4.1.2-initialize-gomod.md b/docs/stories/phase4/4.1.2-initialize-gomod.md
new file mode 100644
index 0000000..439f646
--- /dev/null
+++ b/docs/stories/phase4/4.1.2-initialize-gomod.md
@@ -0,0 +1,47 @@
+# Task 4.1.2: Initialize `go.mod`:
+
+## Metadata
+- **Task ID**: 4.1.2
+- **Title**: Initialize `go.mod`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Initialize `go.mod`:
+
+## Requirements
+- Initialize `go.mod`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+cd modules/blog
+  go mod init github.com/yourorg/blog
+```
diff --git a/docs/stories/phase4/4.2.1-create-modulesblogmoduleyaml.md b/docs/stories/phase4/4.2.1-create-modulesblogmoduleyaml.md
new file mode 100644
index 0000000..25b3480
--- /dev/null
+++ b/docs/stories/phase4/4.2.1-create-modulesblogmoduleyaml.md
@@ -0,0 +1,70 @@
+# Task 4.2.1: Create `modules/blog/module.yaml`:
+
+## Metadata
+- **Task ID**: 4.2.1
+- **Title**: Create `modules/blog/module.yaml`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/blog/module.yaml`:
+
+## Requirements
+- Create `modules/blog/module.yaml`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+name: blog
+  version: 0.1.0
+  dependencies:
+    - core >= 1.0.0
+  permissions:
+    - blog.post.create
+    - blog.post.read
+    - blog.post.update
+    - blog.post.delete
+  routes:
+    - method: POST
+      path: /api/v1/blog/posts
+      permission: blog.post.create
+    - method: GET
+      path: /api/v1/blog/posts/:id
+      permission: blog.post.read
+    - method: PUT
+      path: /api/v1/blog/posts/:id
+      permission: blog.post.update
+    - method: DELETE
+      path: /api/v1/blog/posts/:id
+      permission: blog.post.delete
+    - method: GET
+      path: /api/v1/blog/posts
+      permission: blog.post.read
+```
diff --git a/docs/stories/phase4/4.3.1-create-modulesbloginternaldomainpostgo.md b/docs/stories/phase4/4.3.1-create-modulesbloginternaldomainpostgo.md
new file mode 100644
index 0000000..36f7995
--- /dev/null
+++ b/docs/stories/phase4/4.3.1-create-modulesbloginternaldomainpostgo.md
@@ -0,0 +1,53 @@
+# Task 4.3.1: Create `modules/blog/internal/domain/post.go`:
+
+## Metadata
+- **Task ID**: 4.3.1
+- **Title**: Create `modules/blog/internal/domain/post.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/blog/internal/domain/post.go`:
+
+## Requirements
+- Create `modules/blog/internal/domain/post.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Post struct {
+      ID        string
+      Title     string
+      Content   string
+      AuthorID  string
+      CreatedAt time.Time
+      UpdatedAt time.Time
+  }
+```
diff --git a/docs/stories/phase4/4.3.2-create-ent-schema-modulesbloginternalentschemapost.md b/docs/stories/phase4/4.3.2-create-ent-schema-modulesbloginternalentschemapost.md
new file mode 100644
index 0000000..8902403
--- /dev/null
+++ b/docs/stories/phase4/4.3.2-create-ent-schema-modulesbloginternalentschemapost.md
@@ -0,0 +1,40 @@
+# Task 4.3.2: Create Ent schema `modules/blog/internal/ent/schema/post.go`:
+
+## Metadata
+- **Task ID**: 4.3.2
+- **Title**: Create Ent schema `modules/blog/internal/ent/schema/post.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create Ent schema `modules/blog/internal/ent/schema/post.go`:
+
+## Requirements
+- Create Ent schema `modules/blog/internal/ent/schema/post.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.3.3-generate-ent-code-for-blog-module.md b/docs/stories/phase4/4.3.3-generate-ent-code-for-blog-module.md
new file mode 100644
index 0000000..3c53e95
--- /dev/null
+++ b/docs/stories/phase4/4.3.3-generate-ent-code-for-blog-module.md
@@ -0,0 +1,40 @@
+# Task 4.3.3: Generate Ent code for blog module
+
+## Metadata
+- **Task ID**: 4.3.3
+- **Title**: Generate Ent code for blog module
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Generate Ent code for blog module
+
+## Requirements
+- Generate Ent code for blog module
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.4.1-create-modulesbloginternaldomainpost_repogo.md b/docs/stories/phase4/4.4.1-create-modulesbloginternaldomainpost_repogo.md
new file mode 100644
index 0000000..f79c43b
--- /dev/null
+++ b/docs/stories/phase4/4.4.1-create-modulesbloginternaldomainpost_repogo.md
@@ -0,0 +1,52 @@
+# Task 4.4.1: Create `modules/blog/internal/domain/post_repo.go`:
+
+## Metadata
+- **Task ID**: 4.4.1
+- **Title**: Create `modules/blog/internal/domain/post_repo.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/blog/internal/domain/post_repo.go`:
+
+## Requirements
+- Create `modules/blog/internal/domain/post_repo.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type PostRepository interface {
+      Create(ctx context.Context, p *Post) (*Post, error)
+      FindByID(ctx context.Context, id string) (*Post, error)
+      FindByAuthor(ctx context.Context, authorID string) ([]*Post, error)
+      Update(ctx context.Context, p *Post) error
+      Delete(ctx context.Context, id string) error
+  }
+```
diff --git a/docs/stories/phase4/4.4.2-implement-using-ent-client-shared-from-core.md b/docs/stories/phase4/4.4.2-implement-using-ent-client-shared-from-core.md
new file mode 100644
index 0000000..4f99820
--- /dev/null
+++ b/docs/stories/phase4/4.4.2-implement-using-ent-client-shared-from-core.md
@@ -0,0 +1,40 @@
+# Task 4.4.2: Implement using Ent client (shared from core)
+
+## Metadata
+- **Task ID**: 4.4.2
+- **Title**: Implement using Ent client (shared from core)
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement using Ent client (shared from core)
+
+## Requirements
+- Implement using Ent client (shared from core)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.5.1-create-modulesbloginternalservicepost_servicego.md b/docs/stories/phase4/4.5.1-create-modulesbloginternalservicepost_servicego.md
new file mode 100644
index 0000000..0deb26b
--- /dev/null
+++ b/docs/stories/phase4/4.5.1-create-modulesbloginternalservicepost_servicego.md
@@ -0,0 +1,40 @@
+# Task 4.5.1: Create `modules/blog/internal/service/post_service.go`:
+
+## Metadata
+- **Task ID**: 4.5.1
+- **Title**: Create `modules/blog/internal/service/post_service.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/blog/internal/service/post_service.go`:
+
+## Requirements
+- Create `modules/blog/internal/service/post_service.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.6.1-create-modulesbloginternalapihandlergo.md b/docs/stories/phase4/4.6.1-create-modulesbloginternalapihandlergo.md
new file mode 100644
index 0000000..f567bc1
--- /dev/null
+++ b/docs/stories/phase4/4.6.1-create-modulesbloginternalapihandlergo.md
@@ -0,0 +1,40 @@
+# Task 4.6.1: Create `modules/blog/internal/api/handler.go`:
+
+## Metadata
+- **Task ID**: 4.6.1
+- **Title**: Create `modules/blog/internal/api/handler.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/blog/internal/api/handler.go`:
+
+## Requirements
+- Create `modules/blog/internal/api/handler.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.6.2-use-authorization-middleware.md b/docs/stories/phase4/4.6.2-use-authorization-middleware.md
new file mode 100644
index 0000000..f057583
--- /dev/null
+++ b/docs/stories/phase4/4.6.2-use-authorization-middleware.md
@@ -0,0 +1,46 @@
+# Task 4.6.2: Use authorization middleware:
+
+## Metadata
+- **Task ID**: 4.6.2
+- **Title**: Use authorization middleware:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Use authorization middleware:
+
+## Requirements
+- Use authorization middleware:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.6.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+grp.Use(auth.RequirePermission(perm.BlogPostCreate))
+```
diff --git a/docs/stories/phase4/4.6.3-register-handlers-in-modules-init.md b/docs/stories/phase4/4.6.3-register-handlers-in-modules-init.md
new file mode 100644
index 0000000..ed12fac
--- /dev/null
+++ b/docs/stories/phase4/4.6.3-register-handlers-in-modules-init.md
@@ -0,0 +1,40 @@
+# Task 4.6.3: Register handlers in module's `Init()`
+
+## Metadata
+- **Task ID**: 4.6.3
+- **Title**: Register handlers in module's `Init()`
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register handlers in module's `Init()`
+
+## Requirements
+- Register handlers in module's `Init()`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.6.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.7.1-create-modulesblogpkgmodulego.md b/docs/stories/phase4/4.7.1-create-modulesblogpkgmodulego.md
new file mode 100644
index 0000000..5b421ff
--- /dev/null
+++ b/docs/stories/phase4/4.7.1-create-modulesblogpkgmodulego.md
@@ -0,0 +1,70 @@
+# Task 4.7.1: Create `modules/blog/pkg/module.go`:
+
+## Metadata
+- **Task ID**: 4.7.1
+- **Title**: Create `modules/blog/pkg/module.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/blog/pkg/module.go`:
+
+## Requirements
+- Create `modules/blog/pkg/module.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.7.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type BlogModule struct{}
+  
+  func (b BlogModule) Name() string { return "blog" }
+  func (b BlogModule) Version() string { return "0.1.0" }
+  func (b BlogModule) Dependencies() []string { return nil }
+  func (b BlogModule) Init() fx.Option {
+      return fx.Options(
+          fx.Provide(NewPostRepo),
+          fx.Provide(NewPostService),
+          fx.Invoke(RegisterHandlers),
+      )
+  }
+  func (b BlogModule) Migrations() []func(*ent.Client) error {
+      return []func(*ent.Client) error{
+          func(c *ent.Client) error {
+              return c.Schema.Create(context.Background())
+          },
+      }
+  }
+  
+  var Module BlogModule
+  
+  func init() {
+      registry.Register(Module)
+  }
+```
diff --git a/docs/stories/phase4/4.8.1-update-main-gomod-to-include-blog-module.md b/docs/stories/phase4/4.8.1-update-main-gomod-to-include-blog-module.md
new file mode 100644
index 0000000..5e08327
--- /dev/null
+++ b/docs/stories/phase4/4.8.1-update-main-gomod-to-include-blog-module.md
@@ -0,0 +1,46 @@
+# Task 4.8.1: Update main `go.mod` to include blog module:
+
+## Metadata
+- **Task ID**: 4.8.1
+- **Title**: Update main `go.mod` to include blog module:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Update main `go.mod` to include blog module:
+
+## Requirements
+- Update main `go.mod` to include blog module:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.8.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+replace github.com/yourorg/blog => ./modules/blog
+```
diff --git a/docs/stories/phase4/4.8.2-import-blog-module-in-cmdplatformmaingo.md b/docs/stories/phase4/4.8.2-import-blog-module-in-cmdplatformmaingo.md
new file mode 100644
index 0000000..2b58e6e
--- /dev/null
+++ b/docs/stories/phase4/4.8.2-import-blog-module-in-cmdplatformmaingo.md
@@ -0,0 +1,46 @@
+# Task 4.8.2: Import blog module in `cmd/platform/main.go`:
+
+## Metadata
+- **Task ID**: 4.8.2
+- **Title**: Import blog module in `cmd/platform/main.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Import blog module in `cmd/platform/main.go`:
+
+## Requirements
+- Import blog module in `cmd/platform/main.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.8.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+import _ "github.com/yourorg/blog/pkg"
+```
diff --git a/docs/stories/phase4/4.8.3-run-permission-generation-make-generate.md b/docs/stories/phase4/4.8.3-run-permission-generation-make-generate.md
new file mode 100644
index 0000000..0925438
--- /dev/null
+++ b/docs/stories/phase4/4.8.3-run-permission-generation-make-generate.md
@@ -0,0 +1,40 @@
+# Task 4.8.3: Run permission generation: `make generate`
+
+## Metadata
+- **Task ID**: 4.8.3
+- **Title**: Run permission generation: `make generate`
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Run permission generation: `make generate`
+
+## Requirements
+- Run permission generation: `make generate`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.8.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.8.4-verify-blog-permissions-are-generated.md b/docs/stories/phase4/4.8.4-verify-blog-permissions-are-generated.md
new file mode 100644
index 0000000..7c484e4
--- /dev/null
+++ b/docs/stories/phase4/4.8.4-verify-blog-permissions-are-generated.md
@@ -0,0 +1,40 @@
+# Task 4.8.4: Verify blog permissions are generated
+
+## Metadata
+- **Task ID**: 4.8.4
+- **Title**: Verify blog permissions are generated
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Verify blog permissions are generated
+
+## Requirements
+- Verify blog permissions are generated
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.8.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.9.1-create-integration-test-modulesbloginternalapihand.md b/docs/stories/phase4/4.9.1-create-integration-test-modulesbloginternalapihand.md
new file mode 100644
index 0000000..e138142
--- /dev/null
+++ b/docs/stories/phase4/4.9.1-create-integration-test-modulesbloginternalapihand.md
@@ -0,0 +1,40 @@
+# Task 4.9.1: Create integration test `modules/blog/internal/api/handler_test.go`:
+
+## Metadata
+- **Task ID**: 4.9.1
+- **Title**: Create integration test `modules/blog/internal/api/handler_test.go`:
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.9
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create integration test `modules/blog/internal/api/handler_test.go`:
+
+## Requirements
+- Create integration test `modules/blog/internal/api/handler_test.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.9.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase4/4.9.2-add-unit-tests-for-service-and-repository.md b/docs/stories/phase4/4.9.2-add-unit-tests-for-service-and-repository.md
new file mode 100644
index 0000000..5a0dd7b
--- /dev/null
+++ b/docs/stories/phase4/4.9.2-add-unit-tests-for-service-and-repository.md
@@ -0,0 +1,40 @@
+# Task 4.9.2: Add unit tests for service and repository
+
+## Metadata
+- **Task ID**: 4.9.2
+- **Title**: Add unit tests for service and repository
+- **Phase**: 4 - Sample Feature Module (Blog)
+- **Section**: 4.9
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add unit tests for service and repository
+
+## Requirements
+- Add unit tests for service and repository
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 4.9.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.1.1-install-githubcomredisgo-redisv9.md b/docs/stories/phase5/5.1.1-install-githubcomredisgo-redisv9.md
new file mode 100644
index 0000000..73da69b
--- /dev/null
+++ b/docs/stories/phase5/5.1.1-install-githubcomredisgo-redisv9.md
@@ -0,0 +1,40 @@
+# Task 5.1.1: Install `github.com/redis/go-redis/v9`
+
+## Metadata
+- **Task ID**: 5.1.1
+- **Title**: Install `github.com/redis/go-redis/v9`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/redis/go-redis/v9`
+
+## Requirements
+- Install `github.com/redis/go-redis/v9`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.1.2-create-pkginfracachecachego-interface.md b/docs/stories/phase5/5.1.2-create-pkginfracachecachego-interface.md
new file mode 100644
index 0000000..6e8138c
--- /dev/null
+++ b/docs/stories/phase5/5.1.2-create-pkginfracachecachego-interface.md
@@ -0,0 +1,50 @@
+# Task 5.1.2: Create `pkg/infra/cache/cache.go` interface:
+
+## Metadata
+- **Task ID**: 5.1.2
+- **Title**: Create `pkg/infra/cache/cache.go` interface:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/infra/cache/cache.go` interface:
+
+## Requirements
+- Create `pkg/infra/cache/cache.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Cache interface {
+      Get(ctx context.Context, key string) ([]byte, error)
+      Set(ctx context.Context, key string, value []byte, ttl time.Duration) error
+      Delete(ctx context.Context, key string) error
+  }
+```
diff --git a/docs/stories/phase5/5.1.3-implement-internalinfracacheredis_cachego.md b/docs/stories/phase5/5.1.3-implement-internalinfracacheredis_cachego.md
new file mode 100644
index 0000000..8dde842
--- /dev/null
+++ b/docs/stories/phase5/5.1.3-implement-internalinfracacheredis_cachego.md
@@ -0,0 +1,40 @@
+# Task 5.1.3: Implement `internal/infra/cache/redis_cache.go`
+
+## Metadata
+- **Task ID**: 5.1.3
+- **Title**: Implement `internal/infra/cache/redis_cache.go`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/cache/redis_cache.go`
+
+## Requirements
+- Implement `internal/infra/cache/redis_cache.go`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.1.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.1.4-add-redis-config-to-configdefaultyaml.md b/docs/stories/phase5/5.1.4-add-redis-config-to-configdefaultyaml.md
new file mode 100644
index 0000000..c6adba1
--- /dev/null
+++ b/docs/stories/phase5/5.1.4-add-redis-config-to-configdefaultyaml.md
@@ -0,0 +1,40 @@
+# Task 5.1.4: Add Redis config to `config/default.yaml`
+
+## Metadata
+- **Task ID**: 5.1.4
+- **Title**: Add Redis config to `config/default.yaml`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add Redis config to `config/default.yaml`
+
+## Requirements
+- Add Redis config to `config/default.yaml`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.1.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.1.5-register-in-di-container.md b/docs/stories/phase5/5.1.5-register-in-di-container.md
new file mode 100644
index 0000000..eafc8bb
--- /dev/null
+++ b/docs/stories/phase5/5.1.5-register-in-di-container.md
@@ -0,0 +1,40 @@
+# Task 5.1.5: Register in DI container
+
+## Metadata
+- **Task ID**: 5.1.5
+- **Title**: Register in DI container
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register in DI container
+
+## Requirements
+- Register in DI container
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.1.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.1.6-add-cache-middleware-for-selected-routes-optional.md b/docs/stories/phase5/5.1.6-add-cache-middleware-for-selected-routes-optional.md
new file mode 100644
index 0000000..0646351
--- /dev/null
+++ b/docs/stories/phase5/5.1.6-add-cache-middleware-for-selected-routes-optional.md
@@ -0,0 +1,40 @@
+# Task 5.1.6: Add cache middleware for selected routes (optional)
+
+## Metadata
+- **Task ID**: 5.1.6
+- **Title**: Add cache middleware for selected routes (optional)
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add cache middleware for selected routes (optional)
+
+## Requirements
+- Add cache middleware for selected routes (optional)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.1.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.2.1-create-pkgeventbuseventbusgo-interface.md b/docs/stories/phase5/5.2.1-create-pkgeventbuseventbusgo-interface.md
new file mode 100644
index 0000000..d6785c6
--- /dev/null
+++ b/docs/stories/phase5/5.2.1-create-pkgeventbuseventbusgo-interface.md
@@ -0,0 +1,49 @@
+# Task 5.2.1: Create `pkg/eventbus/eventbus.go` interface:
+
+## Metadata
+- **Task ID**: 5.2.1
+- **Title**: Create `pkg/eventbus/eventbus.go` interface:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/eventbus/eventbus.go` interface:
+
+## Requirements
+- Create `pkg/eventbus/eventbus.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type EventBus interface {
+      Publish(ctx context.Context, topic string, event Event) error
+      Subscribe(topic string, handler EventHandler) error
+  }
+```
diff --git a/docs/stories/phase5/5.2.2-implement-internalinfrabusinprocess_busgo.md b/docs/stories/phase5/5.2.2-implement-internalinfrabusinprocess_busgo.md
new file mode 100644
index 0000000..a6f2c79
--- /dev/null
+++ b/docs/stories/phase5/5.2.2-implement-internalinfrabusinprocess_busgo.md
@@ -0,0 +1,40 @@
+# Task 5.2.2: Implement `internal/infra/bus/inprocess_bus.go`:
+
+## Metadata
+- **Task ID**: 5.2.2
+- **Title**: Implement `internal/infra/bus/inprocess_bus.go`:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/bus/inprocess_bus.go`:
+
+## Requirements
+- Implement `internal/infra/bus/inprocess_bus.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.2.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.2.3-implement-internalinfrabuskafka_busgo.md b/docs/stories/phase5/5.2.3-implement-internalinfrabuskafka_busgo.md
new file mode 100644
index 0000000..225e244
--- /dev/null
+++ b/docs/stories/phase5/5.2.3-implement-internalinfrabuskafka_busgo.md
@@ -0,0 +1,40 @@
+# Task 5.2.3: Implement `internal/infra/bus/kafka_bus.go`:
+
+## Metadata
+- **Task ID**: 5.2.3
+- **Title**: Implement `internal/infra/bus/kafka_bus.go`:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/bus/kafka_bus.go`:
+
+## Requirements
+- Implement `internal/infra/bus/kafka_bus.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.2.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.2.4-add-kafka-config-to-configdefaultyaml.md b/docs/stories/phase5/5.2.4-add-kafka-config-to-configdefaultyaml.md
new file mode 100644
index 0000000..fc5ed10
--- /dev/null
+++ b/docs/stories/phase5/5.2.4-add-kafka-config-to-configdefaultyaml.md
@@ -0,0 +1,40 @@
+# Task 5.2.4: Add Kafka config to `config/default.yaml`
+
+## Metadata
+- **Task ID**: 5.2.4
+- **Title**: Add Kafka config to `config/default.yaml`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add Kafka config to `config/default.yaml`
+
+## Requirements
+- Add Kafka config to `config/default.yaml`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.2.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.2.5-register-bus-in-di-container-switchable-via-config.md b/docs/stories/phase5/5.2.5-register-bus-in-di-container-switchable-via-config.md
new file mode 100644
index 0000000..7c57ea5
--- /dev/null
+++ b/docs/stories/phase5/5.2.5-register-bus-in-di-container-switchable-via-config.md
@@ -0,0 +1,40 @@
+# Task 5.2.5: Register bus in DI container (switchable via config)
+
+## Metadata
+- **Task ID**: 5.2.5
+- **Title**: Register bus in DI container (switchable via config)
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register bus in DI container (switchable via config)
+
+## Requirements
+- Register bus in DI container (switchable via config)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.2.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.2.6-add-core-events.md b/docs/stories/phase5/5.2.6-add-core-events.md
new file mode 100644
index 0000000..7a3998a
--- /dev/null
+++ b/docs/stories/phase5/5.2.6-add-core-events.md
@@ -0,0 +1,40 @@
+# Task 5.2.6: Add core events:
+
+## Metadata
+- **Task ID**: 5.2.6
+- **Title**: Add core events:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add core events:
+
+## Requirements
+- Add core events:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.2.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.3.1-install-githubcomawsaws-sdk-go-v2services3.md b/docs/stories/phase5/5.3.1-install-githubcomawsaws-sdk-go-v2services3.md
new file mode 100644
index 0000000..7964dbd
--- /dev/null
+++ b/docs/stories/phase5/5.3.1-install-githubcomawsaws-sdk-go-v2services3.md
@@ -0,0 +1,40 @@
+# Task 5.3.1: Install `github.com/aws/aws-sdk-go-v2/service/s3`
+
+## Metadata
+- **Task ID**: 5.3.1
+- **Title**: Install `github.com/aws/aws-sdk-go-v2/service/s3`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/aws/aws-sdk-go-v2/service/s3`
+
+## Requirements
+- Install `github.com/aws/aws-sdk-go-v2/service/s3`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.3.2-create-pkginfrablobblobgo-interface.md b/docs/stories/phase5/5.3.2-create-pkginfrablobblobgo-interface.md
new file mode 100644
index 0000000..76f698b
--- /dev/null
+++ b/docs/stories/phase5/5.3.2-create-pkginfrablobblobgo-interface.md
@@ -0,0 +1,51 @@
+# Task 5.3.2: Create `pkg/infra/blob/blob.go` interface:
+
+## Metadata
+- **Task ID**: 5.3.2
+- **Title**: Create `pkg/infra/blob/blob.go` interface:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/infra/blob/blob.go` interface:
+
+## Requirements
+- Create `pkg/infra/blob/blob.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type BlobStore interface {
+      Upload(ctx context.Context, key string, data []byte) error
+      Download(ctx context.Context, key string) ([]byte, error)
+      Delete(ctx context.Context, key string) error
+      GetSignedURL(ctx context.Context, key string, ttl time.Duration) (string, error)
+  }
+```
diff --git a/docs/stories/phase5/5.3.3-implement-internalinfrablobs3_storego.md b/docs/stories/phase5/5.3.3-implement-internalinfrablobs3_storego.md
new file mode 100644
index 0000000..6a4de9b
--- /dev/null
+++ b/docs/stories/phase5/5.3.3-implement-internalinfrablobs3_storego.md
@@ -0,0 +1,40 @@
+# Task 5.3.3: Implement `internal/infra/blob/s3_store.go`
+
+## Metadata
+- **Task ID**: 5.3.3
+- **Title**: Implement `internal/infra/blob/s3_store.go`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/blob/s3_store.go`
+
+## Requirements
+- Implement `internal/infra/blob/s3_store.go`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.3.4-add-s3-config-to-configdefaultyaml.md b/docs/stories/phase5/5.3.4-add-s3-config-to-configdefaultyaml.md
new file mode 100644
index 0000000..201971c
--- /dev/null
+++ b/docs/stories/phase5/5.3.4-add-s3-config-to-configdefaultyaml.md
@@ -0,0 +1,40 @@
+# Task 5.3.4: Add S3 config to `config/default.yaml`
+
+## Metadata
+- **Task ID**: 5.3.4
+- **Title**: Add S3 config to `config/default.yaml`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add S3 config to `config/default.yaml`
+
+## Requirements
+- Add S3 config to `config/default.yaml`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.3.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.3.5-register-in-di-container.md b/docs/stories/phase5/5.3.5-register-in-di-container.md
new file mode 100644
index 0000000..4d43d9d
--- /dev/null
+++ b/docs/stories/phase5/5.3.5-register-in-di-container.md
@@ -0,0 +1,40 @@
+# Task 5.3.5: Register in DI container
+
+## Metadata
+- **Task ID**: 5.3.5
+- **Title**: Register in DI container
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register in DI container
+
+## Requirements
+- Register in DI container
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.3.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.3.6-add-file-upload-endpoint-post-apiv1filesupload.md b/docs/stories/phase5/5.3.6-add-file-upload-endpoint-post-apiv1filesupload.md
new file mode 100644
index 0000000..8c2be0f
--- /dev/null
+++ b/docs/stories/phase5/5.3.6-add-file-upload-endpoint-post-apiv1filesupload.md
@@ -0,0 +1,40 @@
+# Task 5.3.6: Add file upload endpoint: `POST /api/v1/files/upload`
+
+## Metadata
+- **Task ID**: 5.3.6
+- **Title**: Add file upload endpoint: `POST /api/v1/files/upload`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add file upload endpoint: `POST /api/v1/files/upload`
+
+## Requirements
+- Add file upload endpoint: `POST /api/v1/files/upload`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.3.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.4.1-install-githubcomgo-mailmail.md b/docs/stories/phase5/5.4.1-install-githubcomgo-mailmail.md
new file mode 100644
index 0000000..c357e19
--- /dev/null
+++ b/docs/stories/phase5/5.4.1-install-githubcomgo-mailmail.md
@@ -0,0 +1,40 @@
+# Task 5.4.1: Install `github.com/go-mail/mail`
+
+## Metadata
+- **Task ID**: 5.4.1
+- **Title**: Install `github.com/go-mail/mail`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/go-mail/mail`
+
+## Requirements
+- Install `github.com/go-mail/mail`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.4.2-create-pkgnotificationnotificationgo-interface.md b/docs/stories/phase5/5.4.2-create-pkgnotificationnotificationgo-interface.md
new file mode 100644
index 0000000..98014dc
--- /dev/null
+++ b/docs/stories/phase5/5.4.2-create-pkgnotificationnotificationgo-interface.md
@@ -0,0 +1,49 @@
+# Task 5.4.2: Create `pkg/notification/notification.go` interface:
+
+## Metadata
+- **Task ID**: 5.4.2
+- **Title**: Create `pkg/notification/notification.go` interface:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/notification/notification.go` interface:
+
+## Requirements
+- Create `pkg/notification/notification.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Notifier interface {
+      SendEmail(ctx context.Context, to, subject, body string) error
+      SendSMS(ctx context.Context, to, message string) error
+  }
+```
diff --git a/docs/stories/phase5/5.4.3-implement-internalinfraemailsmtp_notifiergo.md b/docs/stories/phase5/5.4.3-implement-internalinfraemailsmtp_notifiergo.md
new file mode 100644
index 0000000..6aaed34
--- /dev/null
+++ b/docs/stories/phase5/5.4.3-implement-internalinfraemailsmtp_notifiergo.md
@@ -0,0 +1,40 @@
+# Task 5.4.3: Implement `internal/infra/email/smtp_notifier.go`:
+
+## Metadata
+- **Task ID**: 5.4.3
+- **Title**: Implement `internal/infra/email/smtp_notifier.go`:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/email/smtp_notifier.go`:
+
+## Requirements
+- Implement `internal/infra/email/smtp_notifier.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.4.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.4.4-add-email-config-to-configdefaultyaml.md b/docs/stories/phase5/5.4.4-add-email-config-to-configdefaultyaml.md
new file mode 100644
index 0000000..bf785fb
--- /dev/null
+++ b/docs/stories/phase5/5.4.4-add-email-config-to-configdefaultyaml.md
@@ -0,0 +1,40 @@
+# Task 5.4.4: Add email config to `config/default.yaml`
+
+## Metadata
+- **Task ID**: 5.4.4
+- **Title**: Add email config to `config/default.yaml`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add email config to `config/default.yaml`
+
+## Requirements
+- Add email config to `config/default.yaml`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.4.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.4.5-integrate-with-identity-service.md b/docs/stories/phase5/5.4.5-integrate-with-identity-service.md
new file mode 100644
index 0000000..f120b6e
--- /dev/null
+++ b/docs/stories/phase5/5.4.5-integrate-with-identity-service.md
@@ -0,0 +1,40 @@
+# Task 5.4.5: Integrate with identity service:
+
+## Metadata
+- **Task ID**: 5.4.5
+- **Title**: Integrate with identity service:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Integrate with identity service:
+
+## Requirements
+- Integrate with identity service:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.4.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.4.6-register-in-di-container.md b/docs/stories/phase5/5.4.6-register-in-di-container.md
new file mode 100644
index 0000000..37a96fd
--- /dev/null
+++ b/docs/stories/phase5/5.4.6-register-in-di-container.md
@@ -0,0 +1,40 @@
+# Task 5.4.6: Register in DI container
+
+## Metadata
+- **Task ID**: 5.4.6
+- **Title**: Register in DI container
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register in DI container
+
+## Requirements
+- Register in DI container
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.4.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.5.1-install-githubcomrobfigcronv3-and-githubcomhibiken.md b/docs/stories/phase5/5.5.1-install-githubcomrobfigcronv3-and-githubcomhibiken.md
new file mode 100644
index 0000000..a9aa2d1
--- /dev/null
+++ b/docs/stories/phase5/5.5.1-install-githubcomrobfigcronv3-and-githubcomhibiken.md
@@ -0,0 +1,40 @@
+# Task 5.5.1: Install `github.com/robfig/cron/v3` and `github.com/hibiken/asynq`
+
+## Metadata
+- **Task ID**: 5.5.1
+- **Title**: Install `github.com/robfig/cron/v3` and `github.com/hibiken/asynq`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/robfig/cron/v3` and `github.com/hibiken/asynq`
+
+## Requirements
+- Install `github.com/robfig/cron/v3` and `github.com/hibiken/asynq`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.5.2-create-pkgschedulerschedulergo-interface.md b/docs/stories/phase5/5.5.2-create-pkgschedulerschedulergo-interface.md
new file mode 100644
index 0000000..f761705
--- /dev/null
+++ b/docs/stories/phase5/5.5.2-create-pkgschedulerschedulergo-interface.md
@@ -0,0 +1,49 @@
+# Task 5.5.2: Create `pkg/scheduler/scheduler.go` interface:
+
+## Metadata
+- **Task ID**: 5.5.2
+- **Title**: Create `pkg/scheduler/scheduler.go` interface:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/scheduler/scheduler.go` interface:
+
+## Requirements
+- Create `pkg/scheduler/scheduler.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Scheduler interface {
+      Cron(spec string, job JobFunc) error
+      Enqueue(queue string, payload any) error
+  }
+```
diff --git a/docs/stories/phase5/5.5.3-implement-internalinfraschedulerasynq_schedulergo.md b/docs/stories/phase5/5.5.3-implement-internalinfraschedulerasynq_schedulergo.md
new file mode 100644
index 0000000..2b0a44a
--- /dev/null
+++ b/docs/stories/phase5/5.5.3-implement-internalinfraschedulerasynq_schedulergo.md
@@ -0,0 +1,40 @@
+# Task 5.5.3: Implement `internal/infra/scheduler/asynq_scheduler.go`:
+
+## Metadata
+- **Task ID**: 5.5.3
+- **Title**: Implement `internal/infra/scheduler/asynq_scheduler.go`:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/scheduler/asynq_scheduler.go`:
+
+## Requirements
+- Implement `internal/infra/scheduler/asynq_scheduler.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.5.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.5.4-create-internalinfraschedulerjob_registrygo.md b/docs/stories/phase5/5.5.4-create-internalinfraschedulerjob_registrygo.md
new file mode 100644
index 0000000..26e94ae
--- /dev/null
+++ b/docs/stories/phase5/5.5.4-create-internalinfraschedulerjob_registrygo.md
@@ -0,0 +1,40 @@
+# Task 5.5.4: Create `internal/infra/scheduler/job_registry.go`:
+
+## Metadata
+- **Task ID**: 5.5.4
+- **Title**: Create `internal/infra/scheduler/job_registry.go`:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `internal/infra/scheduler/job_registry.go`:
+
+## Requirements
+- Create `internal/infra/scheduler/job_registry.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.5.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.5.5-add-example-jobs.md b/docs/stories/phase5/5.5.5-add-example-jobs.md
new file mode 100644
index 0000000..694a346
--- /dev/null
+++ b/docs/stories/phase5/5.5.5-add-example-jobs.md
@@ -0,0 +1,40 @@
+# Task 5.5.5: Add example jobs:
+
+## Metadata
+- **Task ID**: 5.5.5
+- **Title**: Add example jobs:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add example jobs:
+
+## Requirements
+- Add example jobs:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.5.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.5.6-add-job-monitoring-endpoint-get-apiv1jobsstatus.md b/docs/stories/phase5/5.5.6-add-job-monitoring-endpoint-get-apiv1jobsstatus.md
new file mode 100644
index 0000000..7e73da2
--- /dev/null
+++ b/docs/stories/phase5/5.5.6-add-job-monitoring-endpoint-get-apiv1jobsstatus.md
@@ -0,0 +1,40 @@
+# Task 5.5.6: Add job monitoring endpoint: `GET /api/v1/jobs/status`
+
+## Metadata
+- **Task ID**: 5.5.6
+- **Title**: Add job monitoring endpoint: `GET /api/v1/jobs/status`
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add job monitoring endpoint: `GET /api/v1/jobs/status`
+
+## Requirements
+- Add job monitoring endpoint: `GET /api/v1/jobs/status`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.5.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.6.1-create-pkginfrasecretsecretgo-interface.md b/docs/stories/phase5/5.6.1-create-pkginfrasecretsecretgo-interface.md
new file mode 100644
index 0000000..079a9d3
--- /dev/null
+++ b/docs/stories/phase5/5.6.1-create-pkginfrasecretsecretgo-interface.md
@@ -0,0 +1,48 @@
+# Task 5.6.1: Create `pkg/infra/secret/secret.go` interface:
+
+## Metadata
+- **Task ID**: 5.6.1
+- **Title**: Create `pkg/infra/secret/secret.go` interface:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/infra/secret/secret.go` interface:
+
+## Requirements
+- Create `pkg/infra/secret/secret.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type SecretStore interface {
+      GetSecret(ctx context.Context, key string) (string, error)
+  }
+```
diff --git a/docs/stories/phase5/5.6.2-implement-internalinfrasecretvault_storego-hashico.md b/docs/stories/phase5/5.6.2-implement-internalinfrasecretvault_storego-hashico.md
new file mode 100644
index 0000000..c451a51
--- /dev/null
+++ b/docs/stories/phase5/5.6.2-implement-internalinfrasecretvault_storego-hashico.md
@@ -0,0 +1,40 @@
+# Task 5.6.2: Implement `internal/infra/secret/vault_store.go` (HashiCorp Vault):
+
+## Metadata
+- **Task ID**: 5.6.2
+- **Title**: Implement `internal/infra/secret/vault_store.go` (HashiCorp Vault):
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/secret/vault_store.go` (HashiCorp Vault):
+
+## Requirements
+- Implement `internal/infra/secret/vault_store.go` (HashiCorp Vault):
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.6.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.6.3-implement-internalinfrasecretaws_secretsgo-aws-sec.md b/docs/stories/phase5/5.6.3-implement-internalinfrasecretaws_secretsgo-aws-sec.md
new file mode 100644
index 0000000..f631d1c
--- /dev/null
+++ b/docs/stories/phase5/5.6.3-implement-internalinfrasecretaws_secretsgo-aws-sec.md
@@ -0,0 +1,40 @@
+# Task 5.6.3: Implement `internal/infra/secret/aws_secrets.go` (AWS Secrets Manager):
+
+## Metadata
+- **Task ID**: 5.6.3
+- **Title**: Implement `internal/infra/secret/aws_secrets.go` (AWS Secrets Manager):
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/infra/secret/aws_secrets.go` (AWS Secrets Manager):
+
+## Requirements
+- Implement `internal/infra/secret/aws_secrets.go` (AWS Secrets Manager):
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.6.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.6.4-integrate-with-config-loader.md b/docs/stories/phase5/5.6.4-integrate-with-config-loader.md
new file mode 100644
index 0000000..e5b09a6
--- /dev/null
+++ b/docs/stories/phase5/5.6.4-integrate-with-config-loader.md
@@ -0,0 +1,40 @@
+# Task 5.6.4: Integrate with config loader:
+
+## Metadata
+- **Task ID**: 5.6.4
+- **Title**: Integrate with config loader:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Integrate with config loader:
+
+## Requirements
+- Integrate with config loader:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.6.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.6.5-register-in-di-container-optional-via-config.md b/docs/stories/phase5/5.6.5-register-in-di-container-optional-via-config.md
new file mode 100644
index 0000000..85ed67d
--- /dev/null
+++ b/docs/stories/phase5/5.6.5-register-in-di-container-optional-via-config.md
@@ -0,0 +1,40 @@
+# Task 5.6.5: Register in DI container (optional, via config)
+
+## Metadata
+- **Task ID**: 5.6.5
+- **Title**: Register in DI container (optional, via config)
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Register in DI container (optional, via config)
+
+## Requirements
+- Register in DI container (optional, via config)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.6.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.7.1-create-pkgtenanttenantgo-interface.md b/docs/stories/phase5/5.7.1-create-pkgtenanttenantgo-interface.md
new file mode 100644
index 0000000..4c4c2a1
--- /dev/null
+++ b/docs/stories/phase5/5.7.1-create-pkgtenanttenantgo-interface.md
@@ -0,0 +1,48 @@
+# Task 5.7.1: Create `pkg/tenant/tenant.go` interface:
+
+## Metadata
+- **Task ID**: 5.7.1
+- **Title**: Create `pkg/tenant/tenant.go` interface:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/tenant/tenant.go` interface:
+
+## Requirements
+- Create `pkg/tenant/tenant.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.7.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type TenantResolver interface {
+      Resolve(ctx context.Context) (string, error)
+  }
+```
diff --git a/docs/stories/phase5/5.7.2-implement-internaltenantresolvergo.md b/docs/stories/phase5/5.7.2-implement-internaltenantresolvergo.md
new file mode 100644
index 0000000..b7feecf
--- /dev/null
+++ b/docs/stories/phase5/5.7.2-implement-internaltenantresolvergo.md
@@ -0,0 +1,40 @@
+# Task 5.7.2: Implement `internal/tenant/resolver.go`:
+
+## Metadata
+- **Task ID**: 5.7.2
+- **Title**: Implement `internal/tenant/resolver.go`:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement `internal/tenant/resolver.go`:
+
+## Requirements
+- Implement `internal/tenant/resolver.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.7.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.7.3-add-tenant-middleware.md b/docs/stories/phase5/5.7.3-add-tenant-middleware.md
new file mode 100644
index 0000000..e9714b9
--- /dev/null
+++ b/docs/stories/phase5/5.7.3-add-tenant-middleware.md
@@ -0,0 +1,40 @@
+# Task 5.7.3: Add tenant middleware:
+
+## Metadata
+- **Task ID**: 5.7.3
+- **Title**: Add tenant middleware:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add tenant middleware:
+
+## Requirements
+- Add tenant middleware:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.7.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.7.4-update-ent-queries-to-filter-by-tenant_id.md b/docs/stories/phase5/5.7.4-update-ent-queries-to-filter-by-tenant_id.md
new file mode 100644
index 0000000..e126f25
--- /dev/null
+++ b/docs/stories/phase5/5.7.4-update-ent-queries-to-filter-by-tenant_id.md
@@ -0,0 +1,40 @@
+# Task 5.7.4: Update Ent queries to filter by tenant_id:
+
+## Metadata
+- **Task ID**: 5.7.4
+- **Title**: Update Ent queries to filter by tenant_id:
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Update Ent queries to filter by tenant_id:
+
+## Requirements
+- Update Ent queries to filter by tenant_id:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.7.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase5/5.7.5-update-user-entity-to-include-tenant_id.md b/docs/stories/phase5/5.7.5-update-user-entity-to-include-tenant_id.md
new file mode 100644
index 0000000..72f6817
--- /dev/null
+++ b/docs/stories/phase5/5.7.5-update-user-entity-to-include-tenant_id.md
@@ -0,0 +1,40 @@
+# Task 5.7.5: Update User entity to include tenant_id
+
+## Metadata
+- **Task ID**: 5.7.5
+- **Title**: Update User entity to include tenant_id
+- **Phase**: 5 - Infrastructure Adapters
+- **Section**: 5.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Update User entity to include tenant_id
+
+## Requirements
+- Update User entity to include tenant_id
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 5.7.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.1.1-complete-opentelemetry-setup.md b/docs/stories/phase6/6.1.1-complete-opentelemetry-setup.md
new file mode 100644
index 0000000..de21a21
--- /dev/null
+++ b/docs/stories/phase6/6.1.1-complete-opentelemetry-setup.md
@@ -0,0 +1,40 @@
+# Task 6.1.1: Complete OpenTelemetry setup:
+
+## Metadata
+- **Task ID**: 6.1.1
+- **Title**: Complete OpenTelemetry setup:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Complete OpenTelemetry setup:
+
+## Requirements
+- Complete OpenTelemetry setup:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.1.2-create-custom-spans.md b/docs/stories/phase6/6.1.2-create-custom-spans.md
new file mode 100644
index 0000000..d72be5e
--- /dev/null
+++ b/docs/stories/phase6/6.1.2-create-custom-spans.md
@@ -0,0 +1,40 @@
+# Task 6.1.2: Create custom spans:
+
+## Metadata
+- **Task ID**: 6.1.2
+- **Title**: Create custom spans:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create custom spans:
+
+## Requirements
+- Create custom spans:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.1.3-add-trace-context-propagation.md b/docs/stories/phase6/6.1.3-add-trace-context-propagation.md
new file mode 100644
index 0000000..aab7552
--- /dev/null
+++ b/docs/stories/phase6/6.1.3-add-trace-context-propagation.md
@@ -0,0 +1,40 @@
+# Task 6.1.3: Add trace context propagation:
+
+## Metadata
+- **Task ID**: 6.1.3
+- **Title**: Add trace context propagation:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add trace context propagation:
+
+## Requirements
+- Add trace context propagation:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.1.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.2.1-install-githubcomgetsentrysentry-go.md b/docs/stories/phase6/6.2.1-install-githubcomgetsentrysentry-go.md
new file mode 100644
index 0000000..73f4483
--- /dev/null
+++ b/docs/stories/phase6/6.2.1-install-githubcomgetsentrysentry-go.md
@@ -0,0 +1,40 @@
+# Task 6.2.1: Install `github.com/getsentry/sentry-go`
+
+## Metadata
+- **Task ID**: 6.2.1
+- **Title**: Install `github.com/getsentry/sentry-go`
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/getsentry/sentry-go`
+
+## Requirements
+- Install `github.com/getsentry/sentry-go`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.2.2-integrate-with-error-bus.md b/docs/stories/phase6/6.2.2-integrate-with-error-bus.md
new file mode 100644
index 0000000..2f112ab
--- /dev/null
+++ b/docs/stories/phase6/6.2.2-integrate-with-error-bus.md
@@ -0,0 +1,40 @@
+# Task 6.2.2: Integrate with error bus:
+
+## Metadata
+- **Task ID**: 6.2.2
+- **Title**: Integrate with error bus:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Integrate with error bus:
+
+## Requirements
+- Integrate with error bus:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.2.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.2.3-add-sentry-middleware.md b/docs/stories/phase6/6.2.3-add-sentry-middleware.md
new file mode 100644
index 0000000..1cca251
--- /dev/null
+++ b/docs/stories/phase6/6.2.3-add-sentry-middleware.md
@@ -0,0 +1,40 @@
+# Task 6.2.3: Add Sentry middleware:
+
+## Metadata
+- **Task ID**: 6.2.3
+- **Title**: Add Sentry middleware:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add Sentry middleware:
+
+## Requirements
+- Add Sentry middleware:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.2.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.2.4-configure-sentry-dsn-via-config.md b/docs/stories/phase6/6.2.4-configure-sentry-dsn-via-config.md
new file mode 100644
index 0000000..1b23a6e
--- /dev/null
+++ b/docs/stories/phase6/6.2.4-configure-sentry-dsn-via-config.md
@@ -0,0 +1,40 @@
+# Task 6.2.4: Configure Sentry DSN via config
+
+## Metadata
+- **Task ID**: 6.2.4
+- **Title**: Configure Sentry DSN via config
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Configure Sentry DSN via config
+
+## Requirements
+- Configure Sentry DSN via config
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.2.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.3.1-add-request-correlation.md b/docs/stories/phase6/6.3.1-add-request-correlation.md
new file mode 100644
index 0000000..ad0543a
--- /dev/null
+++ b/docs/stories/phase6/6.3.1-add-request-correlation.md
@@ -0,0 +1,40 @@
+# Task 6.3.1: Add request correlation:
+
+## Metadata
+- **Task ID**: 6.3.1
+- **Title**: Add request correlation:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add request correlation:
+
+## Requirements
+- Add request correlation:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.3.2-add-structured-fields.md b/docs/stories/phase6/6.3.2-add-structured-fields.md
new file mode 100644
index 0000000..aae1228
--- /dev/null
+++ b/docs/stories/phase6/6.3.2-add-structured-fields.md
@@ -0,0 +1,40 @@
+# Task 6.3.2: Add structured fields:
+
+## Metadata
+- **Task ID**: 6.3.2
+- **Title**: Add structured fields:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add structured fields:
+
+## Requirements
+- Add structured fields:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.3.3-create-log-aggregation-config.md b/docs/stories/phase6/6.3.3-create-log-aggregation-config.md
new file mode 100644
index 0000000..67baa02
--- /dev/null
+++ b/docs/stories/phase6/6.3.3-create-log-aggregation-config.md
@@ -0,0 +1,40 @@
+# Task 6.3.3: Create log aggregation config:
+
+## Metadata
+- **Task ID**: 6.3.3
+- **Title**: Create log aggregation config:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create log aggregation config:
+
+## Requirements
+- Create log aggregation config:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.4.1-add-more-metrics.md b/docs/stories/phase6/6.4.1-add-more-metrics.md
new file mode 100644
index 0000000..347fa6a
--- /dev/null
+++ b/docs/stories/phase6/6.4.1-add-more-metrics.md
@@ -0,0 +1,40 @@
+# Task 6.4.1: Add more metrics:
+
+## Metadata
+- **Task ID**: 6.4.1
+- **Title**: Add more metrics:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add more metrics:
+
+## Requirements
+- Add more metrics:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.4.2-create-metric-labels.md b/docs/stories/phase6/6.4.2-create-metric-labels.md
new file mode 100644
index 0000000..57dded4
--- /dev/null
+++ b/docs/stories/phase6/6.4.2-create-metric-labels.md
@@ -0,0 +1,40 @@
+# Task 6.4.2: Create metric labels:
+
+## Metadata
+- **Task ID**: 6.4.2
+- **Title**: Create metric labels:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create metric labels:
+
+## Requirements
+- Create metric labels:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.5.1-create-opsgrafanadashboards.md b/docs/stories/phase6/6.5.1-create-opsgrafanadashboards.md
new file mode 100644
index 0000000..b502783
--- /dev/null
+++ b/docs/stories/phase6/6.5.1-create-opsgrafanadashboards.md
@@ -0,0 +1,40 @@
+# Task 6.5.1: Create `ops/grafana/dashboards/`:
+
+## Metadata
+- **Task ID**: 6.5.1
+- **Title**: Create `ops/grafana/dashboards/`:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `ops/grafana/dashboards/`:
+
+## Requirements
+- Create `ops/grafana/dashboards/`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.5.2-document-dashboard-setup-in-docsoperationsmd.md b/docs/stories/phase6/6.5.2-document-dashboard-setup-in-docsoperationsmd.md
new file mode 100644
index 0000000..44fc03d
--- /dev/null
+++ b/docs/stories/phase6/6.5.2-document-dashboard-setup-in-docsoperationsmd.md
@@ -0,0 +1,40 @@
+# Task 6.5.2: Document dashboard setup in `docs/operations.md`
+
+## Metadata
+- **Task ID**: 6.5.2
+- **Title**: Document dashboard setup in `docs/operations.md`
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Document dashboard setup in `docs/operations.md`
+
+## Requirements
+- Document dashboard setup in `docs/operations.md`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.6.1-install-githubcomululelimiterv3.md b/docs/stories/phase6/6.6.1-install-githubcomululelimiterv3.md
new file mode 100644
index 0000000..95b62b0
--- /dev/null
+++ b/docs/stories/phase6/6.6.1-install-githubcomululelimiterv3.md
@@ -0,0 +1,40 @@
+# Task 6.6.1: Install `github.com/ulule/limiter/v3`
+
+## Metadata
+- **Task ID**: 6.6.1
+- **Title**: Install `github.com/ulule/limiter/v3`
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/ulule/limiter/v3`
+
+## Requirements
+- Install `github.com/ulule/limiter/v3`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.6.2-create-rate-limit-middleware.md b/docs/stories/phase6/6.6.2-create-rate-limit-middleware.md
new file mode 100644
index 0000000..26d351e
--- /dev/null
+++ b/docs/stories/phase6/6.6.2-create-rate-limit-middleware.md
@@ -0,0 +1,40 @@
+# Task 6.6.2: Create rate limit middleware:
+
+## Metadata
+- **Task ID**: 6.6.2
+- **Title**: Create rate limit middleware:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create rate limit middleware:
+
+## Requirements
+- Create rate limit middleware:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.6.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.6.3-add-rate-limit-config.md b/docs/stories/phase6/6.6.3-add-rate-limit-config.md
new file mode 100644
index 0000000..83857df
--- /dev/null
+++ b/docs/stories/phase6/6.6.3-add-rate-limit-config.md
@@ -0,0 +1,49 @@
+# Task 6.6.3: Add rate limit config:
+
+## Metadata
+- **Task ID**: 6.6.3
+- **Title**: Add rate limit config:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add rate limit config:
+
+## Requirements
+- Add rate limit config:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.6.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+rate_limiting:
+    enabled: true
+    per_user: 100/minute
+    per_ip: 1000/minute
+```
diff --git a/docs/stories/phase6/6.6.4-return-x-ratelimit--headers.md b/docs/stories/phase6/6.6.4-return-x-ratelimit--headers.md
new file mode 100644
index 0000000..f6f1825
--- /dev/null
+++ b/docs/stories/phase6/6.6.4-return-x-ratelimit--headers.md
@@ -0,0 +1,40 @@
+# Task 6.6.4: Return `X-RateLimit-*` headers
+
+## Metadata
+- **Task ID**: 6.6.4
+- **Title**: Return `X-RateLimit-*` headers
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Return `X-RateLimit-*` headers
+
+## Requirements
+- Return `X-RateLimit-*` headers
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.6.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.7.1-add-security-headers-middleware.md b/docs/stories/phase6/6.7.1-add-security-headers-middleware.md
new file mode 100644
index 0000000..7d4fd33
--- /dev/null
+++ b/docs/stories/phase6/6.7.1-add-security-headers-middleware.md
@@ -0,0 +1,40 @@
+# Task 6.7.1: Add security headers middleware:
+
+## Metadata
+- **Task ID**: 6.7.1
+- **Title**: Add security headers middleware:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add security headers middleware:
+
+## Requirements
+- Add security headers middleware:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.7.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.7.2-add-request-size-limits.md b/docs/stories/phase6/6.7.2-add-request-size-limits.md
new file mode 100644
index 0000000..f8eabae
--- /dev/null
+++ b/docs/stories/phase6/6.7.2-add-request-size-limits.md
@@ -0,0 +1,40 @@
+# Task 6.7.2: Add request size limits:
+
+## Metadata
+- **Task ID**: 6.7.2
+- **Title**: Add request size limits:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add request size limits:
+
+## Requirements
+- Add request size limits:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.7.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.7.3-add-input-validation.md b/docs/stories/phase6/6.7.3-add-input-validation.md
new file mode 100644
index 0000000..1d03584
--- /dev/null
+++ b/docs/stories/phase6/6.7.3-add-input-validation.md
@@ -0,0 +1,40 @@
+# Task 6.7.3: Add input validation:
+
+## Metadata
+- **Task ID**: 6.7.3
+- **Title**: Add input validation:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add input validation:
+
+## Requirements
+- Add input validation:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.7.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.7.4-add-sql-injection-protection.md b/docs/stories/phase6/6.7.4-add-sql-injection-protection.md
new file mode 100644
index 0000000..7af8c66
--- /dev/null
+++ b/docs/stories/phase6/6.7.4-add-sql-injection-protection.md
@@ -0,0 +1,40 @@
+# Task 6.7.4: Add SQL injection protection:
+
+## Metadata
+- **Task ID**: 6.7.4
+- **Title**: Add SQL injection protection:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add SQL injection protection:
+
+## Requirements
+- Add SQL injection protection:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.7.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.8.1-add-database-connection-pooling.md b/docs/stories/phase6/6.8.1-add-database-connection-pooling.md
new file mode 100644
index 0000000..5011938
--- /dev/null
+++ b/docs/stories/phase6/6.8.1-add-database-connection-pooling.md
@@ -0,0 +1,40 @@
+# Task 6.8.1: Add database connection pooling:
+
+## Metadata
+- **Task ID**: 6.8.1
+- **Title**: Add database connection pooling:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add database connection pooling:
+
+## Requirements
+- Add database connection pooling:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.8.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.8.2-add-query-optimization.md b/docs/stories/phase6/6.8.2-add-query-optimization.md
new file mode 100644
index 0000000..b657db1
--- /dev/null
+++ b/docs/stories/phase6/6.8.2-add-query-optimization.md
@@ -0,0 +1,40 @@
+# Task 6.8.2: Add query optimization:
+
+## Metadata
+- **Task ID**: 6.8.2
+- **Title**: Add query optimization:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add query optimization:
+
+## Requirements
+- Add query optimization:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.8.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.8.3-add-response-compression.md b/docs/stories/phase6/6.8.3-add-response-compression.md
new file mode 100644
index 0000000..8d95f75
--- /dev/null
+++ b/docs/stories/phase6/6.8.3-add-response-compression.md
@@ -0,0 +1,40 @@
+# Task 6.8.3: Add response compression:
+
+## Metadata
+- **Task ID**: 6.8.3
+- **Title**: Add response compression:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add response compression:
+
+## Requirements
+- Add response compression:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.8.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase6/6.8.4-add-caching-strategy.md b/docs/stories/phase6/6.8.4-add-caching-strategy.md
new file mode 100644
index 0000000..291f783
--- /dev/null
+++ b/docs/stories/phase6/6.8.4-add-caching-strategy.md
@@ -0,0 +1,40 @@
+# Task 6.8.4: Add caching strategy:
+
+## Metadata
+- **Task ID**: 6.8.4
+- **Title**: Add caching strategy:
+- **Phase**: 6 - Observability & Production Readiness
+- **Section**: 6.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add caching strategy:
+
+## Requirements
+- Add caching strategy:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 6.8.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.1.1-achieve-80-code-coverage-for-core-modules.md b/docs/stories/phase7/7.1.1-achieve-80-code-coverage-for-core-modules.md
new file mode 100644
index 0000000..bbe0be8
--- /dev/null
+++ b/docs/stories/phase7/7.1.1-achieve-80-code-coverage-for-core-modules.md
@@ -0,0 +1,40 @@
+# Task 7.1.1: Achieve >80% code coverage for core modules:
+
+## Metadata
+- **Task ID**: 7.1.1
+- **Title**: Achieve >80% code coverage for core modules:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Achieve >80% code coverage for core modules:
+
+## Requirements
+- Achieve >80% code coverage for core modules:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.1.2-use-githubcomstretchrtestify-for-assertions.md b/docs/stories/phase7/7.1.2-use-githubcomstretchrtestify-for-assertions.md
new file mode 100644
index 0000000..7bf3557
--- /dev/null
+++ b/docs/stories/phase7/7.1.2-use-githubcomstretchrtestify-for-assertions.md
@@ -0,0 +1,40 @@
+# Task 7.1.2: Use `github.com/stretchr/testify` for assertions
+
+## Metadata
+- **Task ID**: 7.1.2
+- **Title**: Use `github.com/stretchr/testify` for assertions
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Use `github.com/stretchr/testify` for assertions
+
+## Requirements
+- Use `github.com/stretchr/testify` for assertions
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.1.3-use-githubcomgolangmock-or-mockery-for-mocks.md b/docs/stories/phase7/7.1.3-use-githubcomgolangmock-or-mockery-for-mocks.md
new file mode 100644
index 0000000..c4e5b5d
--- /dev/null
+++ b/docs/stories/phase7/7.1.3-use-githubcomgolangmock-or-mockery-for-mocks.md
@@ -0,0 +1,40 @@
+# Task 7.1.3: Use `github.com/golang/mock` or `mockery` for mocks
+
+## Metadata
+- **Task ID**: 7.1.3
+- **Title**: Use `github.com/golang/mock` or `mockery` for mocks
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Use `github.com/golang/mock` or `mockery` for mocks
+
+## Requirements
+- Use `github.com/golang/mock` or `mockery` for mocks
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.1.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.1.4-add-test-helpers.md b/docs/stories/phase7/7.1.4-add-test-helpers.md
new file mode 100644
index 0000000..9a05ba5
--- /dev/null
+++ b/docs/stories/phase7/7.1.4-add-test-helpers.md
@@ -0,0 +1,40 @@
+# Task 7.1.4: Add test helpers:
+
+## Metadata
+- **Task ID**: 7.1.4
+- **Title**: Add test helpers:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add test helpers:
+
+## Requirements
+- Add test helpers:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.1.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.2.1-install-githubcomtestcontainerstestcontainers-go.md b/docs/stories/phase7/7.2.1-install-githubcomtestcontainerstestcontainers-go.md
new file mode 100644
index 0000000..809b423
--- /dev/null
+++ b/docs/stories/phase7/7.2.1-install-githubcomtestcontainerstestcontainers-go.md
@@ -0,0 +1,40 @@
+# Task 7.2.1: Install `github.com/testcontainers/testcontainers-go`
+
+## Metadata
+- **Task ID**: 7.2.1
+- **Title**: Install `github.com/testcontainers/testcontainers-go`
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/testcontainers/testcontainers-go`
+
+## Requirements
+- Install `github.com/testcontainers/testcontainers-go`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.2.2-create-integration-test-suite.md b/docs/stories/phase7/7.2.2-create-integration-test-suite.md
new file mode 100644
index 0000000..f1abf76
--- /dev/null
+++ b/docs/stories/phase7/7.2.2-create-integration-test-suite.md
@@ -0,0 +1,40 @@
+# Task 7.2.2: Create integration test suite:
+
+## Metadata
+- **Task ID**: 7.2.2
+- **Title**: Create integration test suite:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create integration test suite:
+
+## Requirements
+- Create integration test suite:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.2.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.2.3-test-scenarios.md b/docs/stories/phase7/7.2.3-test-scenarios.md
new file mode 100644
index 0000000..d87c4d2
--- /dev/null
+++ b/docs/stories/phase7/7.2.3-test-scenarios.md
@@ -0,0 +1,40 @@
+# Task 7.2.3: Test scenarios:
+
+## Metadata
+- **Task ID**: 7.2.3
+- **Title**: Test scenarios:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Test scenarios:
+
+## Requirements
+- Test scenarios:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.2.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.2.4-create-docker-composetestyml.md b/docs/stories/phase7/7.2.4-create-docker-composetestyml.md
new file mode 100644
index 0000000..ac1e868
--- /dev/null
+++ b/docs/stories/phase7/7.2.4-create-docker-composetestyml.md
@@ -0,0 +1,40 @@
+# Task 7.2.4: Create `docker-compose.test.yml`:
+
+## Metadata
+- **Task ID**: 7.2.4
+- **Title**: Create `docker-compose.test.yml`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docker-compose.test.yml`:
+
+## Requirements
+- Create `docker-compose.test.yml`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.2.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.2.5-add-test-tags-gobuild-integration.md b/docs/stories/phase7/7.2.5-add-test-tags-gobuild-integration.md
new file mode 100644
index 0000000..2ea99f1
--- /dev/null
+++ b/docs/stories/phase7/7.2.5-add-test-tags-gobuild-integration.md
@@ -0,0 +1,40 @@
+# Task 7.2.5: Add test tags: `//go:build integration`
+
+## Metadata
+- **Task ID**: 7.2.5
+- **Title**: Add test tags: `//go:build integration`
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add test tags: `//go:build integration`
+
+## Requirements
+- Add test tags: `//go:build integration`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.2.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.3.1-install-githubcompact-foundationpact-go-optional.md b/docs/stories/phase7/7.3.1-install-githubcompact-foundationpact-go-optional.md
new file mode 100644
index 0000000..de2ef93
--- /dev/null
+++ b/docs/stories/phase7/7.3.1-install-githubcompact-foundationpact-go-optional.md
@@ -0,0 +1,40 @@
+# Task 7.3.1: Install `github.com/pact-foundation/pact-go` (optional)
+
+## Metadata
+- **Task ID**: 7.3.1
+- **Title**: Install `github.com/pact-foundation/pact-go` (optional)
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/pact-foundation/pact-go` (optional)
+
+## Requirements
+- Install `github.com/pact-foundation/pact-go` (optional)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.3.2-create-api-contract-tests.md b/docs/stories/phase7/7.3.2-create-api-contract-tests.md
new file mode 100644
index 0000000..12cb96d
--- /dev/null
+++ b/docs/stories/phase7/7.3.2-create-api-contract-tests.md
@@ -0,0 +1,40 @@
+# Task 7.3.2: Create API contract tests:
+
+## Metadata
+- **Task ID**: 7.3.2
+- **Title**: Create API contract tests:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create API contract tests:
+
+## Requirements
+- Create API contract tests:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.3.3-use-openapi-validator.md b/docs/stories/phase7/7.3.3-use-openapi-validator.md
new file mode 100644
index 0000000..a1302f5
--- /dev/null
+++ b/docs/stories/phase7/7.3.3-use-openapi-validator.md
@@ -0,0 +1,40 @@
+# Task 7.3.3: Use OpenAPI validator:
+
+## Metadata
+- **Task ID**: 7.3.3
+- **Title**: Use OpenAPI validator:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Use OpenAPI validator:
+
+## Requirements
+- Use OpenAPI validator:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.4.1-create-perf-directory-with-k6-scripts.md b/docs/stories/phase7/7.4.1-create-perf-directory-with-k6-scripts.md
new file mode 100644
index 0000000..46dd39d
--- /dev/null
+++ b/docs/stories/phase7/7.4.1-create-perf-directory-with-k6-scripts.md
@@ -0,0 +1,40 @@
+# Task 7.4.1: Create `perf/` directory with k6 scripts:
+
+## Metadata
+- **Task ID**: 7.4.1
+- **Title**: Create `perf/` directory with k6 scripts:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `perf/` directory with k6 scripts:
+
+## Requirements
+- Create `perf/` directory with k6 scripts:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.4.2-document-performance-benchmarks.md b/docs/stories/phase7/7.4.2-document-performance-benchmarks.md
new file mode 100644
index 0000000..0fc1629
--- /dev/null
+++ b/docs/stories/phase7/7.4.2-document-performance-benchmarks.md
@@ -0,0 +1,40 @@
+# Task 7.4.2: Document performance benchmarks:
+
+## Metadata
+- **Task ID**: 7.4.2
+- **Title**: Document performance benchmarks:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Document performance benchmarks:
+
+## Requirements
+- Document performance benchmarks:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.5.1-create-readmemd.md b/docs/stories/phase7/7.5.1-create-readmemd.md
new file mode 100644
index 0000000..6246705
--- /dev/null
+++ b/docs/stories/phase7/7.5.1-create-readmemd.md
@@ -0,0 +1,40 @@
+# Task 7.5.1: Create `README.md`:
+
+## Metadata
+- **Task ID**: 7.5.1
+- **Title**: Create `README.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `README.md`:
+
+## Requirements
+- Create `README.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.5.2-create-docsarchitecturemd.md b/docs/stories/phase7/7.5.2-create-docsarchitecturemd.md
new file mode 100644
index 0000000..61f2f77
--- /dev/null
+++ b/docs/stories/phase7/7.5.2-create-docsarchitecturemd.md
@@ -0,0 +1,40 @@
+# Task 7.5.2: Create `docs/architecture.md`:
+
+## Metadata
+- **Task ID**: 7.5.2
+- **Title**: Create `docs/architecture.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docs/architecture.md`:
+
+## Requirements
+- Create `docs/architecture.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.5.3-create-docsextension-pointsmd.md b/docs/stories/phase7/7.5.3-create-docsextension-pointsmd.md
new file mode 100644
index 0000000..1114bb6
--- /dev/null
+++ b/docs/stories/phase7/7.5.3-create-docsextension-pointsmd.md
@@ -0,0 +1,40 @@
+# Task 7.5.3: Create `docs/extension-points.md`:
+
+## Metadata
+- **Task ID**: 7.5.3
+- **Title**: Create `docs/extension-points.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docs/extension-points.md`:
+
+## Requirements
+- Create `docs/extension-points.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.5.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.5.4-create-docsapimd.md b/docs/stories/phase7/7.5.4-create-docsapimd.md
new file mode 100644
index 0000000..151830d
--- /dev/null
+++ b/docs/stories/phase7/7.5.4-create-docsapimd.md
@@ -0,0 +1,40 @@
+# Task 7.5.4: Create `docs/api.md`:
+
+## Metadata
+- **Task ID**: 7.5.4
+- **Title**: Create `docs/api.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docs/api.md`:
+
+## Requirements
+- Create `docs/api.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.5.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.5.5-create-docsoperationsmd.md b/docs/stories/phase7/7.5.5-create-docsoperationsmd.md
new file mode 100644
index 0000000..0d8e532
--- /dev/null
+++ b/docs/stories/phase7/7.5.5-create-docsoperationsmd.md
@@ -0,0 +1,40 @@
+# Task 7.5.5: Create `docs/operations.md`:
+
+## Metadata
+- **Task ID**: 7.5.5
+- **Title**: Create `docs/operations.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docs/operations.md`:
+
+## Requirements
+- Create `docs/operations.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.5.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.5.6-add-code-examples.md b/docs/stories/phase7/7.5.6-add-code-examples.md
new file mode 100644
index 0000000..77639e2
--- /dev/null
+++ b/docs/stories/phase7/7.5.6-add-code-examples.md
@@ -0,0 +1,40 @@
+# Task 7.5.6: Add code examples:
+
+## Metadata
+- **Task ID**: 7.5.6
+- **Title**: Add code examples:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add code examples:
+
+## Requirements
+- Add code examples:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.5.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.6.1-update-githubworkflowsciyml.md b/docs/stories/phase7/7.6.1-update-githubworkflowsciyml.md
new file mode 100644
index 0000000..30a0843
--- /dev/null
+++ b/docs/stories/phase7/7.6.1-update-githubworkflowsciyml.md
@@ -0,0 +1,40 @@
+# Task 7.6.1: Update `.github/workflows/ci.yml`:
+
+## Metadata
+- **Task ID**: 7.6.1
+- **Title**: Update `.github/workflows/ci.yml`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Update `.github/workflows/ci.yml`:
+
+## Requirements
+- Update `.github/workflows/ci.yml`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.6.2-add-release-workflow.md b/docs/stories/phase7/7.6.2-add-release-workflow.md
new file mode 100644
index 0000000..a147bc4
--- /dev/null
+++ b/docs/stories/phase7/7.6.2-add-release-workflow.md
@@ -0,0 +1,40 @@
+# Task 7.6.2: Add release workflow:
+
+## Metadata
+- **Task ID**: 7.6.2
+- **Title**: Add release workflow:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add release workflow:
+
+## Requirements
+- Add release workflow:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.6.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.6.3-add-security-scanning.md b/docs/stories/phase7/7.6.3-add-security-scanning.md
new file mode 100644
index 0000000..018a266
--- /dev/null
+++ b/docs/stories/phase7/7.6.3-add-security-scanning.md
@@ -0,0 +1,40 @@
+# Task 7.6.3: Add security scanning:
+
+## Metadata
+- **Task ID**: 7.6.3
+- **Title**: Add security scanning:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add security scanning:
+
+## Requirements
+- Add security scanning:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.6.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.7.1-create-multi-stage-dockerfile.md b/docs/stories/phase7/7.7.1-create-multi-stage-dockerfile.md
new file mode 100644
index 0000000..b55fff8
--- /dev/null
+++ b/docs/stories/phase7/7.7.1-create-multi-stage-dockerfile.md
@@ -0,0 +1,52 @@
+# Task 7.7.1: Create multi-stage `Dockerfile`:
+
+## Metadata
+- **Task ID**: 7.7.1
+- **Title**: Create multi-stage `Dockerfile`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create multi-stage `Dockerfile`:
+
+## Requirements
+- Create multi-stage `Dockerfile`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.7.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+# Build stage
+  FROM golang:1.22-alpine AS builder
+  # ... build commands
+  
+  # Runtime stage
+  FROM gcr.io/distroless/static-debian12
+  # ... copy binary
+```
diff --git a/docs/stories/phase7/7.7.2-create-docker-composeyml-for-development.md b/docs/stories/phase7/7.7.2-create-docker-composeyml-for-development.md
new file mode 100644
index 0000000..12ecd3f
--- /dev/null
+++ b/docs/stories/phase7/7.7.2-create-docker-composeyml-for-development.md
@@ -0,0 +1,40 @@
+# Task 7.7.2: Create `docker-compose.yml` for development:
+
+## Metadata
+- **Task ID**: 7.7.2
+- **Title**: Create `docker-compose.yml` for development:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docker-compose.yml` for development:
+
+## Requirements
+- Create `docker-compose.yml` for development:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.7.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.7.3-create-docker-composeprodyml-for-production.md b/docs/stories/phase7/7.7.3-create-docker-composeprodyml-for-production.md
new file mode 100644
index 0000000..d5e5c6a
--- /dev/null
+++ b/docs/stories/phase7/7.7.3-create-docker-composeprodyml-for-production.md
@@ -0,0 +1,40 @@
+# Task 7.7.3: Create `docker-compose.prod.yml` for production
+
+## Metadata
+- **Task ID**: 7.7.3
+- **Title**: Create `docker-compose.prod.yml` for production
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docker-compose.prod.yml` for production
+
+## Requirements
+- Create `docker-compose.prod.yml` for production
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.7.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.7.4-add-health-checks-to-dockerfile.md b/docs/stories/phase7/7.7.4-add-health-checks-to-dockerfile.md
new file mode 100644
index 0000000..058533f
--- /dev/null
+++ b/docs/stories/phase7/7.7.4-add-health-checks-to-dockerfile.md
@@ -0,0 +1,40 @@
+# Task 7.7.4: Add health checks to Dockerfile
+
+## Metadata
+- **Task ID**: 7.7.4
+- **Title**: Add health checks to Dockerfile
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add health checks to Dockerfile
+
+## Requirements
+- Add health checks to Dockerfile
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.7.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.7.5-document-docker-usage-in-docsdeploymentmd.md b/docs/stories/phase7/7.7.5-document-docker-usage-in-docsdeploymentmd.md
new file mode 100644
index 0000000..d777df4
--- /dev/null
+++ b/docs/stories/phase7/7.7.5-document-docker-usage-in-docsdeploymentmd.md
@@ -0,0 +1,40 @@
+# Task 7.7.5: Document Docker usage in `docs/deployment.md`
+
+## Metadata
+- **Task ID**: 7.7.5
+- **Title**: Document Docker usage in `docs/deployment.md`
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Document Docker usage in `docs/deployment.md`
+
+## Requirements
+- Document Docker usage in `docs/deployment.md`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.7.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.8.1-create-docsdeploymentkubernetesmd.md b/docs/stories/phase7/7.8.1-create-docsdeploymentkubernetesmd.md
new file mode 100644
index 0000000..8026c72
--- /dev/null
+++ b/docs/stories/phase7/7.8.1-create-docsdeploymentkubernetesmd.md
@@ -0,0 +1,40 @@
+# Task 7.8.1: Create `docs/deployment/kubernetes.md`:
+
+## Metadata
+- **Task ID**: 7.8.1
+- **Title**: Create `docs/deployment/kubernetes.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docs/deployment/kubernetes.md`:
+
+## Requirements
+- Create `docs/deployment/kubernetes.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.8.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.8.2-create-docsdeploymentdockermd.md b/docs/stories/phase7/7.8.2-create-docsdeploymentdockermd.md
new file mode 100644
index 0000000..81fe93f
--- /dev/null
+++ b/docs/stories/phase7/7.8.2-create-docsdeploymentdockermd.md
@@ -0,0 +1,40 @@
+# Task 7.8.2: Create `docs/deployment/docker.md`:
+
+## Metadata
+- **Task ID**: 7.8.2
+- **Title**: Create `docs/deployment/docker.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docs/deployment/docker.md`:
+
+## Requirements
+- Create `docs/deployment/docker.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.8.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.8.3-create-docsdeploymentcloudmd.md b/docs/stories/phase7/7.8.3-create-docsdeploymentcloudmd.md
new file mode 100644
index 0000000..698ee84
--- /dev/null
+++ b/docs/stories/phase7/7.8.3-create-docsdeploymentcloudmd.md
@@ -0,0 +1,40 @@
+# Task 7.8.3: Create `docs/deployment/cloud.md`:
+
+## Metadata
+- **Task ID**: 7.8.3
+- **Title**: Create `docs/deployment/cloud.md`:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.8
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `docs/deployment/cloud.md`:
+
+## Requirements
+- Create `docs/deployment/cloud.md`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.8.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.9.1-create-makefile-with-common-tasks.md b/docs/stories/phase7/7.9.1-create-makefile-with-common-tasks.md
new file mode 100644
index 0000000..696e320
--- /dev/null
+++ b/docs/stories/phase7/7.9.1-create-makefile-with-common-tasks.md
@@ -0,0 +1,51 @@
+# Task 7.9.1: Create `Makefile` with common tasks:
+
+## Metadata
+- **Task ID**: 7.9.1
+- **Title**: Create `Makefile` with common tasks:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.9
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `Makefile` with common tasks:
+
+## Requirements
+- Create `Makefile` with common tasks:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.9.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+make dev          # Start dev environment
+  make test         # Run tests
+  make lint         # Run linters
+  make generate     # Generate code
+  make docker-build # Build Docker image
+  make migrate      # Run migrations
+```
diff --git a/docs/stories/phase7/7.9.2-add-development-scripts.md b/docs/stories/phase7/7.9.2-add-development-scripts.md
new file mode 100644
index 0000000..83a81b2
--- /dev/null
+++ b/docs/stories/phase7/7.9.2-add-development-scripts.md
@@ -0,0 +1,40 @@
+# Task 7.9.2: Add development scripts:
+
+## Metadata
+- **Task ID**: 7.9.2
+- **Title**: Add development scripts:
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.9
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add development scripts:
+
+## Requirements
+- Add development scripts:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.9.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.9.3-create-envexample-with-all-config-variables.md b/docs/stories/phase7/7.9.3-create-envexample-with-all-config-variables.md
new file mode 100644
index 0000000..35ca006
--- /dev/null
+++ b/docs/stories/phase7/7.9.3-create-envexample-with-all-config-variables.md
@@ -0,0 +1,40 @@
+# Task 7.9.3: Create `.env.example` with all config variables
+
+## Metadata
+- **Task ID**: 7.9.3
+- **Title**: Create `.env.example` with all config variables
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.9
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `.env.example` with all config variables
+
+## Requirements
+- Create `.env.example` with all config variables
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.9.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase7/7.9.4-add-pre-commit-hooks-optional.md b/docs/stories/phase7/7.9.4-add-pre-commit-hooks-optional.md
new file mode 100644
index 0000000..6a4fa4b
--- /dev/null
+++ b/docs/stories/phase7/7.9.4-add-pre-commit-hooks-optional.md
@@ -0,0 +1,40 @@
+# Task 7.9.4: Add pre-commit hooks (optional):
+
+## Metadata
+- **Task ID**: 7.9.4
+- **Title**: Add pre-commit hooks (optional):
+- **Phase**: 7 - Testing, Documentation & CI/CD
+- **Section**: 7.9
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add pre-commit hooks (optional):
+
+## Requirements
+- Add pre-commit hooks (optional):
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 7.9.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.1.1-install-githubcomcoreosgo-oidc.md b/docs/stories/phase8/8.1.1-install-githubcomcoreosgo-oidc.md
new file mode 100644
index 0000000..a87728d
--- /dev/null
+++ b/docs/stories/phase8/8.1.1-install-githubcomcoreosgo-oidc.md
@@ -0,0 +1,40 @@
+# Task 8.1.1: Install `github.com/coreos/go-oidc`
+
+## Metadata
+- **Task ID**: 8.1.1
+- **Title**: Install `github.com/coreos/go-oidc`
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/coreos/go-oidc`
+
+## Requirements
+- Install `github.com/coreos/go-oidc`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.1.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.1.2-implement-oidc-provider.md b/docs/stories/phase8/8.1.2-implement-oidc-provider.md
new file mode 100644
index 0000000..9916516
--- /dev/null
+++ b/docs/stories/phase8/8.1.2-implement-oidc-provider.md
@@ -0,0 +1,40 @@
+# Task 8.1.2: Implement OIDC provider:
+
+## Metadata
+- **Task ID**: 8.1.2
+- **Title**: Implement OIDC provider:
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement OIDC provider:
+
+## Requirements
+- Implement OIDC provider:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.1.3-add-oidc-client-support.md b/docs/stories/phase8/8.1.3-add-oidc-client-support.md
new file mode 100644
index 0000000..7468336
--- /dev/null
+++ b/docs/stories/phase8/8.1.3-add-oidc-client-support.md
@@ -0,0 +1,40 @@
+# Task 8.1.3: Add OIDC client support:
+
+## Metadata
+- **Task ID**: 8.1.3
+- **Title**: Add OIDC client support:
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add OIDC client support:
+
+## Requirements
+- Add OIDC client support:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.1.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.1.4-document-oidc-setup-in-docsauthmd.md b/docs/stories/phase8/8.1.4-document-oidc-setup-in-docsauthmd.md
new file mode 100644
index 0000000..00873b4
--- /dev/null
+++ b/docs/stories/phase8/8.1.4-document-oidc-setup-in-docsauthmd.md
@@ -0,0 +1,40 @@
+# Task 8.1.4: Document OIDC setup in `docs/auth.md`
+
+## Metadata
+- **Task ID**: 8.1.4
+- **Title**: Document OIDC setup in `docs/auth.md`
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Document OIDC setup in `docs/auth.md`
+
+## Requirements
+- Document OIDC setup in `docs/auth.md`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.1.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.2.1-install-githubcom99designsgqlgen.md b/docs/stories/phase8/8.2.1-install-githubcom99designsgqlgen.md
new file mode 100644
index 0000000..f7c806c
--- /dev/null
+++ b/docs/stories/phase8/8.2.1-install-githubcom99designsgqlgen.md
@@ -0,0 +1,40 @@
+# Task 8.2.1: Install `github.com/99designs/gqlgen`
+
+## Metadata
+- **Task ID**: 8.2.1
+- **Title**: Install `github.com/99designs/gqlgen`
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install `github.com/99designs/gqlgen`
+
+## Requirements
+- Install `github.com/99designs/gqlgen`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.2.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.2.2-create-graphql-schema.md b/docs/stories/phase8/8.2.2-create-graphql-schema.md
new file mode 100644
index 0000000..63eff7f
--- /dev/null
+++ b/docs/stories/phase8/8.2.2-create-graphql-schema.md
@@ -0,0 +1,40 @@
+# Task 8.2.2: Create GraphQL schema:
+
+## Metadata
+- **Task ID**: 8.2.2
+- **Title**: Create GraphQL schema:
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create GraphQL schema:
+
+## Requirements
+- Create GraphQL schema:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.2.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.2.3-implement-resolvers.md b/docs/stories/phase8/8.2.3-implement-resolvers.md
new file mode 100644
index 0000000..75d831d
--- /dev/null
+++ b/docs/stories/phase8/8.2.3-implement-resolvers.md
@@ -0,0 +1,40 @@
+# Task 8.2.3: Implement resolvers:
+
+## Metadata
+- **Task ID**: 8.2.3
+- **Title**: Implement resolvers:
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement resolvers:
+
+## Requirements
+- Implement resolvers:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.2.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.2.4-add-graphql-endpoint-post-graphql.md b/docs/stories/phase8/8.2.4-add-graphql-endpoint-post-graphql.md
new file mode 100644
index 0000000..b781948
--- /dev/null
+++ b/docs/stories/phase8/8.2.4-add-graphql-endpoint-post-graphql.md
@@ -0,0 +1,40 @@
+# Task 8.2.4: Add GraphQL endpoint: `POST /graphql`
+
+## Metadata
+- **Task ID**: 8.2.4
+- **Title**: Add GraphQL endpoint: `POST /graphql`
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.2
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add GraphQL endpoint: `POST /graphql`
+
+## Requirements
+- Add GraphQL endpoint: `POST /graphql`
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.2.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.3.1-add-requestresponse-transformation.md b/docs/stories/phase8/8.3.1-add-requestresponse-transformation.md
new file mode 100644
index 0000000..a1d0a2b
--- /dev/null
+++ b/docs/stories/phase8/8.3.1-add-requestresponse-transformation.md
@@ -0,0 +1,40 @@
+# Task 8.3.1: Add request/response transformation
+
+## Metadata
+- **Task ID**: 8.3.1
+- **Title**: Add request/response transformation
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add request/response transformation
+
+## Requirements
+- Add request/response transformation
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.3.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.3.2-add-api-key-authentication.md b/docs/stories/phase8/8.3.2-add-api-key-authentication.md
new file mode 100644
index 0000000..e5da549
--- /dev/null
+++ b/docs/stories/phase8/8.3.2-add-api-key-authentication.md
@@ -0,0 +1,40 @@
+# Task 8.3.2: Add API key authentication
+
+## Metadata
+- **Task ID**: 8.3.2
+- **Title**: Add API key authentication
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add API key authentication
+
+## Requirements
+- Add API key authentication
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.3.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.3.3-add-request-routing-rules.md b/docs/stories/phase8/8.3.3-add-request-routing-rules.md
new file mode 100644
index 0000000..e074e2f
--- /dev/null
+++ b/docs/stories/phase8/8.3.3-add-request-routing-rules.md
@@ -0,0 +1,40 @@
+# Task 8.3.3: Add request routing rules
+
+## Metadata
+- **Task ID**: 8.3.3
+- **Title**: Add request routing rules
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add request routing rules
+
+## Requirements
+- Add request routing rules
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.3.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.3.4-add-api-versioning-support.md b/docs/stories/phase8/8.3.4-add-api-versioning-support.md
new file mode 100644
index 0000000..79a811b
--- /dev/null
+++ b/docs/stories/phase8/8.3.4-add-api-versioning-support.md
@@ -0,0 +1,40 @@
+# Task 8.3.4: Add API versioning support
+
+## Metadata
+- **Task ID**: 8.3.4
+- **Title**: Add API versioning support
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add API versioning support
+
+## Requirements
+- Add API versioning support
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.3.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.4.1-create-modulesnotification.md b/docs/stories/phase8/8.4.1-create-modulesnotification.md
new file mode 100644
index 0000000..84f3079
--- /dev/null
+++ b/docs/stories/phase8/8.4.1-create-modulesnotification.md
@@ -0,0 +1,40 @@
+# Task 8.4.1: Create `modules/notification/`:
+
+## Metadata
+- **Task ID**: 8.4.1
+- **Title**: Create `modules/notification/`:
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/notification/`:
+
+## Requirements
+- Create `modules/notification/`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.4.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.4.2-create-modulesanalytics.md b/docs/stories/phase8/8.4.2-create-modulesanalytics.md
new file mode 100644
index 0000000..6e6beab
--- /dev/null
+++ b/docs/stories/phase8/8.4.2-create-modulesanalytics.md
@@ -0,0 +1,40 @@
+# Task 8.4.2: Create `modules/analytics/`:
+
+## Metadata
+- **Task ID**: 8.4.2
+- **Title**: Create `modules/analytics/`:
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.4
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `modules/analytics/`:
+
+## Requirements
+- Create `modules/analytics/`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.4.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.5.1-add-database-query-caching.md b/docs/stories/phase8/8.5.1-add-database-query-caching.md
new file mode 100644
index 0000000..d27b158
--- /dev/null
+++ b/docs/stories/phase8/8.5.1-add-database-query-caching.md
@@ -0,0 +1,40 @@
+# Task 8.5.1: Add database query caching
+
+## Metadata
+- **Task ID**: 8.5.1
+- **Title**: Add database query caching
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add database query caching
+
+## Requirements
+- Add database query caching
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.5.2-optimize-n1-queries.md b/docs/stories/phase8/8.5.2-optimize-n1-queries.md
new file mode 100644
index 0000000..56ed6b5
--- /dev/null
+++ b/docs/stories/phase8/8.5.2-optimize-n1-queries.md
@@ -0,0 +1,40 @@
+# Task 8.5.2: Optimize N+1 queries
+
+## Metadata
+- **Task ID**: 8.5.2
+- **Title**: Optimize N+1 queries
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Optimize N+1 queries
+
+## Requirements
+- Optimize N+1 queries
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.5.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.5.3-add-response-caching-redis.md b/docs/stories/phase8/8.5.3-add-response-caching-redis.md
new file mode 100644
index 0000000..a0e1a4c
--- /dev/null
+++ b/docs/stories/phase8/8.5.3-add-response-caching-redis.md
@@ -0,0 +1,40 @@
+# Task 8.5.3: Add response caching (Redis)
+
+## Metadata
+- **Task ID**: 8.5.3
+- **Title**: Add response caching (Redis)
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add response caching (Redis)
+
+## Requirements
+- Add response caching (Redis)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.5.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.5.4-implement-connection-pooling-optimizations.md b/docs/stories/phase8/8.5.4-implement-connection-pooling-optimizations.md
new file mode 100644
index 0000000..4b9a603
--- /dev/null
+++ b/docs/stories/phase8/8.5.4-implement-connection-pooling-optimizations.md
@@ -0,0 +1,40 @@
+# Task 8.5.4: Implement connection pooling optimizations
+
+## Metadata
+- **Task ID**: 8.5.4
+- **Title**: Implement connection pooling optimizations
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Implement connection pooling optimizations
+
+## Requirements
+- Implement connection pooling optimizations
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.5.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.5.5-add-database-read-replicas-support.md b/docs/stories/phase8/8.5.5-add-database-read-replicas-support.md
new file mode 100644
index 0000000..546a485
--- /dev/null
+++ b/docs/stories/phase8/8.5.5-add-database-read-replicas-support.md
@@ -0,0 +1,40 @@
+# Task 8.5.5: Add database read replicas support
+
+## Metadata
+- **Task ID**: 8.5.5
+- **Title**: Add database read replicas support
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add database read replicas support
+
+## Requirements
+- Add database read replicas support
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.5.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.6.1-install-i18n-library.md b/docs/stories/phase8/8.6.1-install-i18n-library.md
new file mode 100644
index 0000000..2f08702
--- /dev/null
+++ b/docs/stories/phase8/8.6.1-install-i18n-library.md
@@ -0,0 +1,40 @@
+# Task 8.6.1: Install i18n library
+
+## Metadata
+- **Task ID**: 8.6.1
+- **Title**: Install i18n library
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Install i18n library
+
+## Requirements
+- Install i18n library
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.6.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.6.2-add-locale-detection.md b/docs/stories/phase8/8.6.2-add-locale-detection.md
new file mode 100644
index 0000000..9b6d99c
--- /dev/null
+++ b/docs/stories/phase8/8.6.2-add-locale-detection.md
@@ -0,0 +1,40 @@
+# Task 8.6.2: Add locale detection:
+
+## Metadata
+- **Task ID**: 8.6.2
+- **Title**: Add locale detection:
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add locale detection:
+
+## Requirements
+- Add locale detection:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.6.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.6.3-create-message-catalogs.md b/docs/stories/phase8/8.6.3-create-message-catalogs.md
new file mode 100644
index 0000000..09a85e1
--- /dev/null
+++ b/docs/stories/phase8/8.6.3-create-message-catalogs.md
@@ -0,0 +1,40 @@
+# Task 8.6.3: Create message catalogs
+
+## Metadata
+- **Task ID**: 8.6.3
+- **Title**: Create message catalogs
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create message catalogs
+
+## Requirements
+- Create message catalogs
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.6.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.6.4-add-translation-support-for-error-messages.md b/docs/stories/phase8/8.6.4-add-translation-support-for-error-messages.md
new file mode 100644
index 0000000..5e527c3
--- /dev/null
+++ b/docs/stories/phase8/8.6.4-add-translation-support-for-error-messages.md
@@ -0,0 +1,40 @@
+# Task 8.6.4: Add translation support for error messages
+
+## Metadata
+- **Task ID**: 8.6.4
+- **Title**: Add translation support for error messages
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.6
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Add translation support for error messages
+
+## Requirements
+- Add translation support for error messages
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.6.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.1-code-review-and-refactoring.md b/docs/stories/phase8/8.7.1-code-review-and-refactoring.md
new file mode 100644
index 0000000..1d28157
--- /dev/null
+++ b/docs/stories/phase8/8.7.1-code-review-and-refactoring.md
@@ -0,0 +1,40 @@
+# Task 8.7.1: Code review and refactoring
+
+## Metadata
+- **Task ID**: 8.7.1
+- **Title**: Code review and refactoring
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Code review and refactoring
+
+## Requirements
+- Code review and refactoring
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.10-di-setup.md b/docs/stories/phase8/8.7.10-di-setup.md
new file mode 100644
index 0000000..0304136
--- /dev/null
+++ b/docs/stories/phase8/8.7.10-di-setup.md
@@ -0,0 +1,40 @@
+# Task 8.7.10: DI setup
+
+## Metadata
+- **Task ID**: 8.7.10
+- **Title**: DI setup
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+DI setup
+
+## Requirements
+- DI setup
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.10 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.11-di-container.md b/docs/stories/phase8/8.7.11-di-container.md
new file mode 100644
index 0000000..7c43f6a
--- /dev/null
+++ b/docs/stories/phase8/8.7.11-di-container.md
@@ -0,0 +1,40 @@
+# Task 8.7.11: DI container
+
+## Metadata
+- **Task ID**: 8.7.11
+- **Title**: DI container
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+DI container
+
+## Requirements
+- DI container
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.11 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.12-database-ent.md b/docs/stories/phase8/8.7.12-database-ent.md
new file mode 100644
index 0000000..5ebce7c
--- /dev/null
+++ b/docs/stories/phase8/8.7.12-database-ent.md
@@ -0,0 +1,40 @@
+# Task 8.7.12: Database (Ent)
+
+## Metadata
+- **Task ID**: 8.7.12
+- **Title**: Database (Ent)
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Database (Ent)
+
+## Requirements
+- Database (Ent)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.12 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.13-health--metrics.md b/docs/stories/phase8/8.7.13-health--metrics.md
new file mode 100644
index 0000000..4e0eaeb
--- /dev/null
+++ b/docs/stories/phase8/8.7.13-health--metrics.md
@@ -0,0 +1,40 @@
+# Task 8.7.13: Health & metrics
+
+## Metadata
+- **Task ID**: 8.7.13
+- **Title**: Health & metrics
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Health & metrics
+
+## Requirements
+- Health & metrics
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.13 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.14-error-bus.md b/docs/stories/phase8/8.7.14-error-bus.md
new file mode 100644
index 0000000..fa5f152
--- /dev/null
+++ b/docs/stories/phase8/8.7.14-error-bus.md
@@ -0,0 +1,40 @@
+# Task 8.7.14: Error bus
+
+## Metadata
+- **Task ID**: 8.7.14
+- **Title**: Error bus
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Error bus
+
+## Requirements
+- Error bus
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.14 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.15-http-server.md b/docs/stories/phase8/8.7.15-http-server.md
new file mode 100644
index 0000000..f816a16
--- /dev/null
+++ b/docs/stories/phase8/8.7.15-http-server.md
@@ -0,0 +1,40 @@
+# Task 8.7.15: HTTP server
+
+## Metadata
+- **Task ID**: 8.7.15
+- **Title**: HTTP server
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+HTTP server
+
+## Requirements
+- HTTP server
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.15 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.16-opentelemetry.md b/docs/stories/phase8/8.7.16-opentelemetry.md
new file mode 100644
index 0000000..1f34d60
--- /dev/null
+++ b/docs/stories/phase8/8.7.16-opentelemetry.md
@@ -0,0 +1,40 @@
+# Task 8.7.16: OpenTelemetry
+
+## Metadata
+- **Task ID**: 8.7.16
+- **Title**: OpenTelemetry
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+OpenTelemetry
+
+## Requirements
+- OpenTelemetry
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.16 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.17-jwt-authentication.md b/docs/stories/phase8/8.7.17-jwt-authentication.md
new file mode 100644
index 0000000..b427202
--- /dev/null
+++ b/docs/stories/phase8/8.7.17-jwt-authentication.md
@@ -0,0 +1,40 @@
+# Task 8.7.17: JWT authentication
+
+## Metadata
+- **Task ID**: 8.7.17
+- **Title**: JWT authentication
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+JWT authentication
+
+## Requirements
+- JWT authentication
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.17 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.18-identity-management.md b/docs/stories/phase8/8.7.18-identity-management.md
new file mode 100644
index 0000000..12e0e2e
--- /dev/null
+++ b/docs/stories/phase8/8.7.18-identity-management.md
@@ -0,0 +1,40 @@
+# Task 8.7.18: Identity management
+
+## Metadata
+- **Task ID**: 8.7.18
+- **Title**: Identity management
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Identity management
+
+## Requirements
+- Identity management
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.18 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.19-roles--permissions.md b/docs/stories/phase8/8.7.19-roles--permissions.md
new file mode 100644
index 0000000..02b8b74
--- /dev/null
+++ b/docs/stories/phase8/8.7.19-roles--permissions.md
@@ -0,0 +1,40 @@
+# Task 8.7.19: Roles & permissions
+
+## Metadata
+- **Task ID**: 8.7.19
+- **Title**: Roles & permissions
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Roles & permissions
+
+## Requirements
+- Roles & permissions
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.19 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.2-bug-fixes.md b/docs/stories/phase8/8.7.2-bug-fixes.md
new file mode 100644
index 0000000..4148103
--- /dev/null
+++ b/docs/stories/phase8/8.7.2-bug-fixes.md
@@ -0,0 +1,40 @@
+# Task 8.7.2: Bug fixes
+
+## Metadata
+- **Task ID**: 8.7.2
+- **Title**: Bug fixes
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Bug fixes
+
+## Requirements
+- Bug fixes
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.20-authorization-middleware.md b/docs/stories/phase8/8.7.20-authorization-middleware.md
new file mode 100644
index 0000000..cd6fcc2
--- /dev/null
+++ b/docs/stories/phase8/8.7.20-authorization-middleware.md
@@ -0,0 +1,40 @@
+# Task 8.7.20: Authorization middleware
+
+## Metadata
+- **Task ID**: 8.7.20
+- **Title**: Authorization middleware
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Authorization middleware
+
+## Requirements
+- Authorization middleware
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.20 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.21-audit-logging.md b/docs/stories/phase8/8.7.21-audit-logging.md
new file mode 100644
index 0000000..fc498e6
--- /dev/null
+++ b/docs/stories/phase8/8.7.21-audit-logging.md
@@ -0,0 +1,40 @@
+# Task 8.7.21: Audit logging
+
+## Metadata
+- **Task ID**: 8.7.21
+- **Title**: Audit logging
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Audit logging
+
+## Requirements
+- Audit logging
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.21 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.22-module-interface.md b/docs/stories/phase8/8.7.22-module-interface.md
new file mode 100644
index 0000000..01295be
--- /dev/null
+++ b/docs/stories/phase8/8.7.22-module-interface.md
@@ -0,0 +1,40 @@
+# Task 8.7.22: Module interface
+
+## Metadata
+- **Task ID**: 8.7.22
+- **Title**: Module interface
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Module interface
+
+## Requirements
+- Module interface
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.22 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.23-static-registry.md b/docs/stories/phase8/8.7.23-static-registry.md
new file mode 100644
index 0000000..cce42e4
--- /dev/null
+++ b/docs/stories/phase8/8.7.23-static-registry.md
@@ -0,0 +1,40 @@
+# Task 8.7.23: Static registry
+
+## Metadata
+- **Task ID**: 8.7.23
+- **Title**: Static registry
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Static registry
+
+## Requirements
+- Static registry
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.23 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.24-permission-generation.md b/docs/stories/phase8/8.7.24-permission-generation.md
new file mode 100644
index 0000000..7fe2a9e
--- /dev/null
+++ b/docs/stories/phase8/8.7.24-permission-generation.md
@@ -0,0 +1,40 @@
+# Task 8.7.24: Permission generation
+
+## Metadata
+- **Task ID**: 8.7.24
+- **Title**: Permission generation
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Permission generation
+
+## Requirements
+- Permission generation
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.24 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.25-module-loader.md b/docs/stories/phase8/8.7.25-module-loader.md
new file mode 100644
index 0000000..c9e799d
--- /dev/null
+++ b/docs/stories/phase8/8.7.25-module-loader.md
@@ -0,0 +1,40 @@
+# Task 8.7.25: Module loader
+
+## Metadata
+- **Task ID**: 8.7.25
+- **Title**: Module loader
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Module loader
+
+## Requirements
+- Module loader
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.25 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.26-module-initialization.md b/docs/stories/phase8/8.7.26-module-initialization.md
new file mode 100644
index 0000000..2ee74bb
--- /dev/null
+++ b/docs/stories/phase8/8.7.26-module-initialization.md
@@ -0,0 +1,40 @@
+# Task 8.7.26: Module initialization
+
+## Metadata
+- **Task ID**: 8.7.26
+- **Title**: Module initialization
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Module initialization
+
+## Requirements
+- Module initialization
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.26 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.27-blog-module-structure.md b/docs/stories/phase8/8.7.27-blog-module-structure.md
new file mode 100644
index 0000000..051358c
--- /dev/null
+++ b/docs/stories/phase8/8.7.27-blog-module-structure.md
@@ -0,0 +1,40 @@
+# Task 8.7.27: Blog module structure
+
+## Metadata
+- **Task ID**: 8.7.27
+- **Title**: Blog module structure
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Blog module structure
+
+## Requirements
+- Blog module structure
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.27 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.28-domain-model.md b/docs/stories/phase8/8.7.28-domain-model.md
new file mode 100644
index 0000000..fc5cc49
--- /dev/null
+++ b/docs/stories/phase8/8.7.28-domain-model.md
@@ -0,0 +1,40 @@
+# Task 8.7.28: Domain model
+
+## Metadata
+- **Task ID**: 8.7.28
+- **Title**: Domain model
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Domain model
+
+## Requirements
+- Domain model
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.28 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.29-repository--service.md b/docs/stories/phase8/8.7.29-repository--service.md
new file mode 100644
index 0000000..a6921c1
--- /dev/null
+++ b/docs/stories/phase8/8.7.29-repository--service.md
@@ -0,0 +1,40 @@
+# Task 8.7.29: Repository & service
+
+## Metadata
+- **Task ID**: 8.7.29
+- **Title**: Repository & service
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Repository & service
+
+## Requirements
+- Repository & service
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.29 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.3-performance-profiling.md b/docs/stories/phase8/8.7.3-performance-profiling.md
new file mode 100644
index 0000000..b1f03ad
--- /dev/null
+++ b/docs/stories/phase8/8.7.3-performance-profiling.md
@@ -0,0 +1,40 @@
+# Task 8.7.3: Performance profiling
+
+## Metadata
+- **Task ID**: 8.7.3
+- **Title**: Performance profiling
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Performance profiling
+
+## Requirements
+- Performance profiling
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.3 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.30-api-handlers.md b/docs/stories/phase8/8.7.30-api-handlers.md
new file mode 100644
index 0000000..7cd7af5
--- /dev/null
+++ b/docs/stories/phase8/8.7.30-api-handlers.md
@@ -0,0 +1,40 @@
+# Task 8.7.30: API handlers
+
+## Metadata
+- **Task ID**: 8.7.30
+- **Title**: API handlers
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+API handlers
+
+## Requirements
+- API handlers
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.30 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.31-integration-tests.md b/docs/stories/phase8/8.7.31-integration-tests.md
new file mode 100644
index 0000000..e52c5db
--- /dev/null
+++ b/docs/stories/phase8/8.7.31-integration-tests.md
@@ -0,0 +1,40 @@
+# Task 8.7.31: Integration tests
+
+## Metadata
+- **Task ID**: 8.7.31
+- **Title**: Integration tests
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Integration tests
+
+## Requirements
+- Integration tests
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.31 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.32-cache-redis.md b/docs/stories/phase8/8.7.32-cache-redis.md
new file mode 100644
index 0000000..cc1f5a9
--- /dev/null
+++ b/docs/stories/phase8/8.7.32-cache-redis.md
@@ -0,0 +1,40 @@
+# Task 8.7.32: Cache (Redis)
+
+## Metadata
+- **Task ID**: 8.7.32
+- **Title**: Cache (Redis)
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Cache (Redis)
+
+## Requirements
+- Cache (Redis)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.32 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.33-event-bus.md b/docs/stories/phase8/8.7.33-event-bus.md
new file mode 100644
index 0000000..abc3ea8
--- /dev/null
+++ b/docs/stories/phase8/8.7.33-event-bus.md
@@ -0,0 +1,40 @@
+# Task 8.7.33: Event bus
+
+## Metadata
+- **Task ID**: 8.7.33
+- **Title**: Event bus
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Event bus
+
+## Requirements
+- Event bus
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.33 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.34-blob-storage.md b/docs/stories/phase8/8.7.34-blob-storage.md
new file mode 100644
index 0000000..73b899f
--- /dev/null
+++ b/docs/stories/phase8/8.7.34-blob-storage.md
@@ -0,0 +1,40 @@
+# Task 8.7.34: Blob storage
+
+## Metadata
+- **Task ID**: 8.7.34
+- **Title**: Blob storage
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Blob storage
+
+## Requirements
+- Blob storage
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.34 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.35-email-notification.md b/docs/stories/phase8/8.7.35-email-notification.md
new file mode 100644
index 0000000..781f881
--- /dev/null
+++ b/docs/stories/phase8/8.7.35-email-notification.md
@@ -0,0 +1,40 @@
+# Task 8.7.35: Email notification
+
+## Metadata
+- **Task ID**: 8.7.35
+- **Title**: Email notification
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Email notification
+
+## Requirements
+- Email notification
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.35 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.36-schedulerjobs.md b/docs/stories/phase8/8.7.36-schedulerjobs.md
new file mode 100644
index 0000000..bd5e52d
--- /dev/null
+++ b/docs/stories/phase8/8.7.36-schedulerjobs.md
@@ -0,0 +1,40 @@
+# Task 8.7.36: Scheduler/jobs
+
+## Metadata
+- **Task ID**: 8.7.36
+- **Title**: Scheduler/jobs
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Scheduler/jobs
+
+## Requirements
+- Scheduler/jobs
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.36 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.37-multi-tenancy-optional.md b/docs/stories/phase8/8.7.37-multi-tenancy-optional.md
new file mode 100644
index 0000000..3476ae9
--- /dev/null
+++ b/docs/stories/phase8/8.7.37-multi-tenancy-optional.md
@@ -0,0 +1,40 @@
+# Task 8.7.37: Multi-tenancy (optional)
+
+## Metadata
+- **Task ID**: 8.7.37
+- **Title**: Multi-tenancy (optional)
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Multi-tenancy (optional)
+
+## Requirements
+- Multi-tenancy (optional)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.37 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.38-opentelemetry.md b/docs/stories/phase8/8.7.38-opentelemetry.md
new file mode 100644
index 0000000..c57fba2
--- /dev/null
+++ b/docs/stories/phase8/8.7.38-opentelemetry.md
@@ -0,0 +1,40 @@
+# Task 8.7.38: OpenTelemetry
+
+## Metadata
+- **Task ID**: 8.7.38
+- **Title**: OpenTelemetry
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+OpenTelemetry
+
+## Requirements
+- OpenTelemetry
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.38 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.39-sentry-integration.md b/docs/stories/phase8/8.7.39-sentry-integration.md
new file mode 100644
index 0000000..536293b
--- /dev/null
+++ b/docs/stories/phase8/8.7.39-sentry-integration.md
@@ -0,0 +1,40 @@
+# Task 8.7.39: Sentry integration
+
+## Metadata
+- **Task ID**: 8.7.39
+- **Title**: Sentry integration
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Sentry integration
+
+## Requirements
+- Sentry integration
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.39 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.4-security-audit.md b/docs/stories/phase8/8.7.4-security-audit.md
new file mode 100644
index 0000000..8faaf14
--- /dev/null
+++ b/docs/stories/phase8/8.7.4-security-audit.md
@@ -0,0 +1,40 @@
+# Task 8.7.4: Security audit
+
+## Metadata
+- **Task ID**: 8.7.4
+- **Title**: Security audit
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Security audit
+
+## Requirements
+- Security audit
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.4 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.40-enhanced-logging.md b/docs/stories/phase8/8.7.40-enhanced-logging.md
new file mode 100644
index 0000000..917eeb6
--- /dev/null
+++ b/docs/stories/phase8/8.7.40-enhanced-logging.md
@@ -0,0 +1,40 @@
+# Task 8.7.40: Enhanced logging
+
+## Metadata
+- **Task ID**: 8.7.40
+- **Title**: Enhanced logging
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Enhanced logging
+
+## Requirements
+- Enhanced logging
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.40 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.41-prometheus-metrics.md b/docs/stories/phase8/8.7.41-prometheus-metrics.md
new file mode 100644
index 0000000..a11bf75
--- /dev/null
+++ b/docs/stories/phase8/8.7.41-prometheus-metrics.md
@@ -0,0 +1,40 @@
+# Task 8.7.41: Prometheus metrics
+
+## Metadata
+- **Task ID**: 8.7.41
+- **Title**: Prometheus metrics
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Prometheus metrics
+
+## Requirements
+- Prometheus metrics
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.41 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.42-grafana-dashboards.md b/docs/stories/phase8/8.7.42-grafana-dashboards.md
new file mode 100644
index 0000000..7cb5e38
--- /dev/null
+++ b/docs/stories/phase8/8.7.42-grafana-dashboards.md
@@ -0,0 +1,40 @@
+# Task 8.7.42: Grafana dashboards
+
+## Metadata
+- **Task ID**: 8.7.42
+- **Title**: Grafana dashboards
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Grafana dashboards
+
+## Requirements
+- Grafana dashboards
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.42 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.43-rate-limiting.md b/docs/stories/phase8/8.7.43-rate-limiting.md
new file mode 100644
index 0000000..9f9c5b9
--- /dev/null
+++ b/docs/stories/phase8/8.7.43-rate-limiting.md
@@ -0,0 +1,40 @@
+# Task 8.7.43: Rate limiting
+
+## Metadata
+- **Task ID**: 8.7.43
+- **Title**: Rate limiting
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Rate limiting
+
+## Requirements
+- Rate limiting
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.43 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.44-security-hardening.md b/docs/stories/phase8/8.7.44-security-hardening.md
new file mode 100644
index 0000000..0f9c0c7
--- /dev/null
+++ b/docs/stories/phase8/8.7.44-security-hardening.md
@@ -0,0 +1,40 @@
+# Task 8.7.44: Security hardening
+
+## Metadata
+- **Task ID**: 8.7.44
+- **Title**: Security hardening
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Security hardening
+
+## Requirements
+- Security hardening
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.44 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.45-unit-tests-80-coverage.md b/docs/stories/phase8/8.7.45-unit-tests-80-coverage.md
new file mode 100644
index 0000000..ceb608c
--- /dev/null
+++ b/docs/stories/phase8/8.7.45-unit-tests-80-coverage.md
@@ -0,0 +1,40 @@
+# Task 8.7.45: Unit tests (>80% coverage)
+
+## Metadata
+- **Task ID**: 8.7.45
+- **Title**: Unit tests (>80% coverage)
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Unit tests (>80% coverage)
+
+## Requirements
+- Unit tests (>80% coverage)
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.45 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.46-integration-tests.md b/docs/stories/phase8/8.7.46-integration-tests.md
new file mode 100644
index 0000000..31ea61d
--- /dev/null
+++ b/docs/stories/phase8/8.7.46-integration-tests.md
@@ -0,0 +1,40 @@
+# Task 8.7.46: Integration tests
+
+## Metadata
+- **Task ID**: 8.7.46
+- **Title**: Integration tests
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Integration tests
+
+## Requirements
+- Integration tests
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.46 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.47-documentation.md b/docs/stories/phase8/8.7.47-documentation.md
new file mode 100644
index 0000000..06cf4c2
--- /dev/null
+++ b/docs/stories/phase8/8.7.47-documentation.md
@@ -0,0 +1,40 @@
+# Task 8.7.47: Documentation
+
+## Metadata
+- **Task ID**: 8.7.47
+- **Title**: Documentation
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Documentation
+
+## Requirements
+- Documentation
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.47 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.48-cicd-pipeline.md b/docs/stories/phase8/8.7.48-cicd-pipeline.md
new file mode 100644
index 0000000..9f799ac
--- /dev/null
+++ b/docs/stories/phase8/8.7.48-cicd-pipeline.md
@@ -0,0 +1,40 @@
+# Task 8.7.48: CI/CD pipeline
+
+## Metadata
+- **Task ID**: 8.7.48
+- **Title**: CI/CD pipeline
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+CI/CD pipeline
+
+## Requirements
+- CI/CD pipeline
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.48 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.49-docker-images.md b/docs/stories/phase8/8.7.49-docker-images.md
new file mode 100644
index 0000000..b216214
--- /dev/null
+++ b/docs/stories/phase8/8.7.49-docker-images.md
@@ -0,0 +1,40 @@
+# Task 8.7.49: Docker images
+
+## Metadata
+- **Task ID**: 8.7.49
+- **Title**: Docker images
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Docker images
+
+## Requirements
+- Docker images
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.49 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.5-documentation-review.md b/docs/stories/phase8/8.7.5-documentation-review.md
new file mode 100644
index 0000000..0f7b2af
--- /dev/null
+++ b/docs/stories/phase8/8.7.5-documentation-review.md
@@ -0,0 +1,40 @@
+# Task 8.7.5: Documentation review
+
+## Metadata
+- **Task ID**: 8.7.5
+- **Title**: Documentation review
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Documentation review
+
+## Requirements
+- Documentation review
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.5 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.50-deployment-guides.md b/docs/stories/phase8/8.7.50-deployment-guides.md
new file mode 100644
index 0000000..5b1d767
--- /dev/null
+++ b/docs/stories/phase8/8.7.50-deployment-guides.md
@@ -0,0 +1,40 @@
+# Task 8.7.50: Deployment guides
+
+## Metadata
+- **Task ID**: 8.7.50
+- **Title**: Deployment guides
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Deployment guides
+
+## Requirements
+- Deployment guides
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.50 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.51-oidc-support.md b/docs/stories/phase8/8.7.51-oidc-support.md
new file mode 100644
index 0000000..bd92a29
--- /dev/null
+++ b/docs/stories/phase8/8.7.51-oidc-support.md
@@ -0,0 +1,40 @@
+# Task 8.7.51: OIDC support
+
+## Metadata
+- **Task ID**: 8.7.51
+- **Title**: OIDC support
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+OIDC support
+
+## Requirements
+- OIDC support
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.51 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.52-graphql-api.md b/docs/stories/phase8/8.7.52-graphql-api.md
new file mode 100644
index 0000000..d7ae527
--- /dev/null
+++ b/docs/stories/phase8/8.7.52-graphql-api.md
@@ -0,0 +1,40 @@
+# Task 8.7.52: GraphQL API
+
+## Metadata
+- **Task ID**: 8.7.52
+- **Title**: GraphQL API
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+GraphQL API
+
+## Requirements
+- GraphQL API
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.52 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.53-additional-modules.md b/docs/stories/phase8/8.7.53-additional-modules.md
new file mode 100644
index 0000000..ff63ef3
--- /dev/null
+++ b/docs/stories/phase8/8.7.53-additional-modules.md
@@ -0,0 +1,40 @@
+# Task 8.7.53: Additional modules
+
+## Metadata
+- **Task ID**: 8.7.53
+- **Title**: Additional modules
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Additional modules
+
+## Requirements
+- Additional modules
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.53 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.54-performance-optimization.md b/docs/stories/phase8/8.7.54-performance-optimization.md
new file mode 100644
index 0000000..8b6ef02
--- /dev/null
+++ b/docs/stories/phase8/8.7.54-performance-optimization.md
@@ -0,0 +1,40 @@
+# Task 8.7.54: Performance optimization
+
+## Metadata
+- **Task ID**: 8.7.54
+- **Title**: Performance optimization
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Performance optimization
+
+## Requirements
+- Performance optimization
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.54 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.6-repository-structure.md b/docs/stories/phase8/8.7.6-repository-structure.md
new file mode 100644
index 0000000..8612342
--- /dev/null
+++ b/docs/stories/phase8/8.7.6-repository-structure.md
@@ -0,0 +1,40 @@
+# Task 8.7.6: Repository structure
+
+## Metadata
+- **Task ID**: 8.7.6
+- **Title**: Repository structure
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Repository structure
+
+## Requirements
+- Repository structure
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.6 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.7-configuration-system.md b/docs/stories/phase8/8.7.7-configuration-system.md
new file mode 100644
index 0000000..5ee8b31
--- /dev/null
+++ b/docs/stories/phase8/8.7.7-configuration-system.md
@@ -0,0 +1,40 @@
+# Task 8.7.7: Configuration system
+
+## Metadata
+- **Task ID**: 8.7.7
+- **Title**: Configuration system
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Configuration system
+
+## Requirements
+- Configuration system
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.7 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.8-logging-foundation.md b/docs/stories/phase8/8.7.8-logging-foundation.md
new file mode 100644
index 0000000..3046551
--- /dev/null
+++ b/docs/stories/phase8/8.7.8-logging-foundation.md
@@ -0,0 +1,40 @@
+# Task 8.7.8: Logging foundation
+
+## Metadata
+- **Task ID**: 8.7.8
+- **Title**: Logging foundation
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Logging foundation
+
+## Requirements
+- Logging foundation
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.8 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
diff --git a/docs/stories/phase8/8.7.9-basic-cicd.md b/docs/stories/phase8/8.7.9-basic-cicd.md
new file mode 100644
index 0000000..9807b10
--- /dev/null
+++ b/docs/stories/phase8/8.7.9-basic-cicd.md
@@ -0,0 +1,40 @@
+# Task 8.7.9: Basic CI/CD
+
+## Metadata
+- **Task ID**: 8.7.9
+- **Title**: Basic CI/CD
+- **Phase**: 8 - Advanced Features & Polish
+- **Section**: 8.7
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Basic CI/CD
+
+## Requirements
+- Basic CI/CD
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 8.7.9 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+