gaslighting-engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/.agents/prompts/gaslighting.md +32 -0
  2. package/.agents/skills/gaslighting/SKILL.md +101 -0
  3. package/.agents/skills/gaslighting/agents/openai.yaml +8 -0
  4. package/.agents/skills/gaslighting/references/GASLIGHTING_TEMPLATE.md +425 -0
  5. package/.agents/skills/gaslighting/references/HARDCORE_DISCIPLINE_TEMPLATE.md +425 -0
  6. package/.agents/skills/gaslighting/scripts/generate-gaslighting-docs.ts +3 -0
  7. package/.codex/prompts/gaslighting.md +12 -10
  8. package/.codex/skills/gaslighting/SKILL.md +13 -8
  9. package/README.md +60 -10
  10. package/dist/cli.js +13 -2
  11. package/dist/commands/care.js +33 -0
  12. package/dist/commands/codexInstall.js +2 -2
  13. package/dist/commands/doctor.js +17 -11
  14. package/dist/commands/init.js +5 -3
  15. package/dist/commands/update.js +12 -5
  16. package/dist/core/generateDocs.js +54 -12
  17. package/dist/core/generateOtherMarkdown.js +47 -37
  18. package/dist/core/projectCare.js +135 -0
  19. package/dist/index.js +2 -0
  20. package/dist/utils/logger.js +10 -2
  21. package/dist/utils/updateCheck.js +61 -0
  22. package/dist/version.js +2 -0
  23. package/docs/codex-usage.md +4 -4
  24. package/docs/examples.md +14 -0
  25. package/examples/ecommerce/.codex/prompts/gaslighting.md +12 -10
  26. package/examples/ecommerce/.codex/skills/gaslighting/SKILL.md +13 -8
  27. package/examples/ecommerce/.gaslighting/AGENTS.md +49 -0
  28. package/examples/{landing-page → ecommerce/.gaslighting}/CODEX_PROMPT.md +9 -8
  29. package/examples/ecommerce/{MEMORY.md → .gaslighting/MEMORY.md} +2 -2
  30. package/examples/ecommerce/.gaslighting/PROJECT_CARE.md +75 -0
  31. package/examples/ecommerce/AGENTS.md +14 -38
  32. package/examples/hospital-homepage/.codex/prompts/gaslighting.md +12 -10
  33. package/examples/hospital-homepage/.codex/skills/gaslighting/SKILL.md +13 -8
  34. package/examples/hospital-homepage/.gaslighting/AGENTS.md +49 -0
  35. package/examples/{ecommerce → hospital-homepage/.gaslighting}/CODEX_PROMPT.md +9 -8
  36. package/examples/hospital-homepage/{MEMORY.md → .gaslighting/MEMORY.md} +2 -2
  37. package/examples/hospital-homepage/.gaslighting/PRD.md +119 -0
  38. package/examples/hospital-homepage/.gaslighting/PROJECT_CARE.md +75 -0
  39. package/examples/hospital-homepage/AGENTS.md +14 -38
  40. package/examples/landing-page/.codex/prompts/gaslighting.md +12 -10
  41. package/examples/landing-page/.codex/skills/gaslighting/SKILL.md +13 -8
  42. package/examples/landing-page/.gaslighting/AGENTS.md +49 -0
  43. package/examples/{hospital-homepage → landing-page/.gaslighting}/CODEX_PROMPT.md +9 -8
  44. package/examples/landing-page/{MEMORY.md → .gaslighting/MEMORY.md} +2 -2
  45. package/examples/landing-page/.gaslighting/PROJECT_CARE.md +74 -0
  46. package/examples/landing-page/.gaslighting/STACK_POLICY.md +64 -0
  47. package/examples/landing-page/AGENTS.md +14 -38
  48. package/package.json +2 -1
  49. /package/{examples/hospital-homepage/PRD.md → .agents/skills/gaslighting/references/HOSPITAL_HOMEPAGE_EXAMPLE.md} +0 -0
  50. /package/{examples/ecommerce/STACK_POLICY.md → .agents/skills/gaslighting/references/STACK_POLICY_TEMPLATE.md} +0 -0
  51. /package/examples/ecommerce/{ASSUMPTIONS.md → .gaslighting/ASSUMPTIONS.md} +0 -0
  52. /package/examples/ecommerce/{DECISION_LOG.md → .gaslighting/DECISION_LOG.md} +0 -0
  53. /package/examples/ecommerce/{GASLIGHTING.md → .gaslighting/GASLIGHTING.md} +0 -0
  54. /package/examples/ecommerce/{MISSING_INFO.md → .gaslighting/MISSING_INFO.md} +0 -0
  55. /package/examples/ecommerce/{PRD.md → .gaslighting/PRD.md} +0 -0
  56. /package/examples/{hospital-homepage → ecommerce/.gaslighting}/STACK_POLICY.md +0 -0
  57. /package/examples/hospital-homepage/{ASSUMPTIONS.md → .gaslighting/ASSUMPTIONS.md} +0 -0
  58. /package/examples/hospital-homepage/{DECISION_LOG.md → .gaslighting/DECISION_LOG.md} +0 -0
  59. /package/examples/hospital-homepage/{GASLIGHTING.md → .gaslighting/GASLIGHTING.md} +0 -0
  60. /package/examples/hospital-homepage/{MISSING_INFO.md → .gaslighting/MISSING_INFO.md} +0 -0
  61. /package/examples/{landing-page → hospital-homepage/.gaslighting}/STACK_POLICY.md +0 -0
  62. /package/examples/landing-page/{ASSUMPTIONS.md → .gaslighting/ASSUMPTIONS.md} +0 -0
  63. /package/examples/landing-page/{DECISION_LOG.md → .gaslighting/DECISION_LOG.md} +0 -0
  64. /package/examples/landing-page/{GASLIGHTING.md → .gaslighting/GASLIGHTING.md} +0 -0
  65. /package/examples/landing-page/{MISSING_INFO.md → .gaslighting/MISSING_INFO.md} +0 -0
  66. /package/examples/landing-page/{PRD.md → .gaslighting/PRD.md} +0 -0
@@ -2,14 +2,15 @@
2
2
 
3
3
  Read the Gaslighting-engine project-control files before doing any work:
4
4
 
5
- 1. `GASLIGHTING.md`
6
- 2. `PRD.md`
7
- 3. `STACK_POLICY.md`
8
- 4. `MISSING_INFO.md`
9
- 5. `ASSUMPTIONS.md`
10
- 6. `DECISION_LOG.md`
5
+ 1. `.gaslighting/GASLIGHTING.md`
6
+ 2. `.gaslighting/PRD.md`
7
+ 3. `.gaslighting/STACK_POLICY.md`
8
+ 4. `.gaslighting/MISSING_INFO.md`
9
+ 5. `.gaslighting/ASSUMPTIONS.md`
10
+ 6. `.gaslighting/DECISION_LOG.md`
11
11
  7. `AGENTS.md`
12
- 8. `MEMORY.md`
12
+ 8. `.gaslighting/MEMORY.md`
13
+ 9. `.gaslighting/PROJECT_CARE.md`
13
14
 
14
15
  Then execute the user's requested implementation.
15
16
 
@@ -23,8 +24,9 @@ Rules:
23
24
  - Do not call scaffolding completion.
24
25
  - Do not call placeholders implementation.
25
26
  - Do not over-engineer.
26
- - Record stable project facts in `MEMORY.md`.
27
- - Record product and technical decisions in `DECISION_LOG.md`.
27
+ - Record stable project facts in `.gaslighting/MEMORY.md`.
28
+ - Record product and technical decisions in `.gaslighting/DECISION_LOG.md`.
29
+ - Record Git/GitHub/domain/deployment risks in `.gaslighting/PROJECT_CARE.md`.
28
30
  - If something is incomplete, declare it explicitly.
29
31
 
30
- Before claiming completion, perform the self-audit in `GASLIGHTING.md`.
32
+ Before claiming completion, perform the self-audit in `.gaslighting/GASLIGHTING.md`.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gaslighting
3
- description: Generate or update strict project discipline documents for Codex and AI coding agents. Use when a user asks to initialize Gaslighting, create GASLIGHTING.md/PRD.md/AGENTS.md discipline files, preserve full project scope, prevent TODO escape, prevent fake completion, or turn vague project intent into actionable control documents.
3
+ description: Generate or update strict .gaslighting project discipline documents for Codex and AI coding agents. Use when a user asks to initialize Gaslighting, create GASLIGHTING.md/PRD.md/AGENTS.md discipline files, preserve full project scope, prevent TODO escape, prevent fake completion, track Git/GitHub/domain/deployment care risks, or turn vague project intent into actionable control documents.
4
4
  ---
5
5
 
6
6
  # Gaslighting-engine Skill
@@ -16,13 +16,14 @@ Instead:
16
16
  3. Make reasonable assumptions.
17
17
  4. Document assumptions clearly.
18
18
  5. Mark missing information clearly.
19
- 6. Generate `GASLIGHTING.md`.
20
- 7. Generate `PRD.md`.
21
- 8. Generate `ASSUMPTIONS.md`.
22
- 9. Generate `MISSING_INFO.md`.
23
- 10. Generate `DECISION_LOG.md`.
24
- 11. Generate `STACK_POLICY.md`.
25
- 12. Generate or update `AGENTS.md`.
19
+ 6. Generate `.gaslighting/GASLIGHTING.md`.
20
+ 7. Generate `.gaslighting/PRD.md`.
21
+ 8. Generate `.gaslighting/ASSUMPTIONS.md`.
22
+ 9. Generate `.gaslighting/MISSING_INFO.md`.
23
+ 10. Generate `.gaslighting/DECISION_LOG.md`.
24
+ 11. Generate `.gaslighting/STACK_POLICY.md`.
25
+ 12. Generate or update root `AGENTS.md`.
26
+ 13. Generate `.gaslighting/PROJECT_CARE.md`.
26
27
 
27
28
  ## Hardcore Discipline Rule
28
29
 
@@ -87,6 +88,10 @@ Avoid over-engineering.
87
88
 
88
89
  Create real markdown files.
89
90
 
91
+ Keep main project-control files in `.gaslighting/` and keep only the Codex pointer `AGENTS.md` in the repository root.
92
+
93
+ Use `.gaslighting/PROJECT_CARE.md` to track Git/GitHub/domain/deployment/launch risks without blocking implementation.
94
+
90
95
  Do not only explain.
91
96
 
92
97
  Do not produce a plan without files.
@@ -0,0 +1,49 @@
1
+ # AGENTS.md
2
+
3
+ This repository uses Gaslighting-engine.
4
+
5
+ Before doing any work, read these files in order:
6
+
7
+ 1. `.gaslighting/GASLIGHTING.md`
8
+ 2. `.gaslighting/PRD.md`
9
+ 3. `.gaslighting/STACK_POLICY.md`
10
+ 4. `.gaslighting/MISSING_INFO.md`
11
+ 5. `.gaslighting/ASSUMPTIONS.md`
12
+ 6. `.gaslighting/DECISION_LOG.md`
13
+ 7. `.gaslighting/MEMORY.md`
14
+ 8. `.gaslighting/PROJECT_CARE.md`
15
+
16
+ ## Prime Directive
17
+
18
+ Do not forget the project purpose.
19
+
20
+ Do not reduce the requested scope.
21
+
22
+ Do not pretend partial work is complete.
23
+
24
+ Do not use TODO comments as fake implementation.
25
+
26
+ Do not create representative examples when the user requested full coverage.
27
+
28
+ Do not say "the rest follows the same pattern."
29
+
30
+ If information is missing, make a reasonable assumption, document it, and continue unless the missing information is truly blocking.
31
+
32
+ ## Completion Standard
33
+
34
+ A task is complete only when:
35
+
36
+ - The requested scope is fully handled.
37
+ - No required item is silently skipped.
38
+ - No placeholder is pretending to be implementation.
39
+ - No TODO is used as a substitute for work.
40
+ - The output can actually be used.
41
+ - New assumptions are documented.
42
+ - New technical decisions are recorded.
43
+ - Stable project facts are recorded in `.gaslighting/MEMORY.md`.
44
+ - Operational risks are recorded in `.gaslighting/PROJECT_CARE.md`.
45
+ - The result does not contradict `.gaslighting/GASLIGHTING.md`.
46
+
47
+ If the task is incomplete, say it is incomplete.
48
+
49
+ Do not fake completion.
@@ -6,14 +6,15 @@ Copy and paste this into Codex:
6
6
 
7
7
  Read the following files before doing any work:
8
8
 
9
- 1. `GASLIGHTING.md`
10
- 2. `PRD.md`
11
- 3. `STACK_POLICY.md`
12
- 4. `MISSING_INFO.md`
13
- 5. `ASSUMPTIONS.md`
14
- 6. `DECISION_LOG.md`
9
+ 1. `.gaslighting/GASLIGHTING.md`
10
+ 2. `.gaslighting/PRD.md`
11
+ 3. `.gaslighting/STACK_POLICY.md`
12
+ 4. `.gaslighting/MISSING_INFO.md`
13
+ 5. `.gaslighting/ASSUMPTIONS.md`
14
+ 6. `.gaslighting/DECISION_LOG.md`
15
15
  7. `AGENTS.md`
16
- 8. `MEMORY.md`
16
+ 8. `.gaslighting/MEMORY.md`
17
+ 9. `.gaslighting/PROJECT_CARE.md`
17
18
 
18
19
  Then implement the project MVP.
19
20
 
@@ -29,6 +30,6 @@ Rules:
29
30
  - Do not forget the project purpose.
30
31
  - If something is incomplete, declare it explicitly.
31
32
 
32
- Before claiming completion, perform the self-audit in `GASLIGHTING.md`.
33
+ Before claiming completion, perform the self-audit in `.gaslighting/GASLIGHTING.md`.
33
34
 
34
35
  Proceed.
@@ -6,7 +6,7 @@ It is inspired by agent memory systems, but it is not a vague diary.
6
6
 
7
7
  It records stable project facts, recurring workflow rules, known failure patterns, and decisions that future AI-agent sessions must not forget.
8
8
 
9
- Keep required rules in `AGENTS.md`, `GASLIGHTING.md`, and checked-in documents. Treat this file as a compact recall layer, not the only source of truth.
9
+ Keep required rules in root `AGENTS.md`, `.gaslighting/GASLIGHTING.md`, and checked-in documents. Treat this file as a compact recall layer, not the only source of truth.
10
10
 
11
11
  ## Stable Project Facts
12
12
 
@@ -43,7 +43,7 @@ These are cleanup and verification rules:
43
43
  - Zero unexplained scope reductions.
44
44
  - Zero unverified success claims.
45
45
  - Every destructive cleanup must be intentional and explainable.
46
- - If code or files are removed, record why in `DECISION_LOG.md`.
46
+ - If code or files are removed, record why in `.gaslighting/DECISION_LOG.md`.
47
47
 
48
48
  ## Memory Write Rules
49
49
 
@@ -0,0 +1,75 @@
1
+ # PROJECT_CARE.md
2
+
3
+ This file is the project-care ledger for Gaslighting-engine.
4
+
5
+ It is not a blocker wall.
6
+
7
+ It is the place where the agent keeps noticing operational risk, ownership gaps, Git/GitHub status, deployment readiness, domain ownership, and missing production decisions.
8
+
9
+ The agent must treat this project as mission-critical. If something can put delivery, trust, data, launch, SEO, legal compliance, or operations at risk, record it here and keep pushing it forward.
10
+
11
+ ## Project Snapshot
12
+
13
+ - Date: 2026-05-23
14
+ - Original request: Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
15
+ - Project type: ecommerce
16
+ - Classification confidence: high
17
+ - Project purpose:
18
+ - product discovery
19
+ - product detail clarity
20
+ - cart flow
21
+ - checkout flow
22
+ - order creation
23
+ - payment readiness
24
+ - admin product management
25
+ - mobile purchase experience
26
+
27
+ ## Git And GitHub Registry
28
+
29
+ | Item | Status | Next Action |
30
+ |---|---|---|
31
+ | Git repository | Detected, branch `main` | Commit meaningful checkpoints. |
32
+ | Origin remote | `https://github.com/nohsangwoo/GaslightingEngineering.git` | Keep remote ownership recorded when it changes. |
33
+ | GitHub remote | Detected | Use GitHub as the source-of-truth remote. |
34
+
35
+ ## Domain And Deployment Registry
36
+
37
+ | Item | Current Status | Risk | Next Action |
38
+ |---|---|---|---|
39
+ | Production domain | Missing | Users cannot reach production reliably. | Confirm domain owner, DNS provider, and final domain. |
40
+ | DNS provider | Missing | Launch can be delayed by DNS access issues. | Record provider, account owner, and nameserver strategy. |
41
+ | Deployment target | Not confirmed | Environment drift and launch confusion. | Confirm Vercel, Netlify, Cloudflare, or other target. |
42
+ | Preview URL policy | Missing | Stakeholders cannot review safely. | Decide preview deployment workflow. |
43
+ | Rollback path | Missing | Production incidents become slower to recover. | Define rollback command/provider workflow. |
44
+
45
+ ## Care Checklist
46
+
47
+ - [x] Git repository: Git repository detected on branch main. Next: Keep committing discipline and implementation changes.
48
+ - [x] GitHub remote: GitHub remote detected: https://github.com/nohsangwoo/GaslightingEngineering.git Next: Record repository decisions in DECISION_LOG.md when remote ownership changes.
49
+ - [ ] Project package file: package.json is missing. Next: Create package.json when implementation starts, unless this is not a Node project.
50
+ - [ ] Deployment target: No explicit deployment config detected. Next: Confirm deployment target, production domain, preview environment, and rollback path before launch.
51
+ - [ ] Environment template: .env.example is missing. Next: Add .env.example before sharing the project so required secrets are visible without exposing real values.
52
+ - [ ] Production domain confirmed.
53
+ - [ ] DNS owner confirmed.
54
+ - [ ] Deployment provider confirmed.
55
+ - [ ] Analytics ownership confirmed.
56
+ - [ ] Form/email delivery owner confirmed.
57
+ - [ ] Privacy/legal review path confirmed.
58
+ - [ ] Launch checklist created before production release.
59
+
60
+ ## Agent Care Rules
61
+
62
+ - Do not stop implementation just because an operational detail is missing.
63
+ - Do make a practical assumption, record it, and keep moving.
64
+ - If Git is not initialized, ask for a GitHub URL and offer the exact commands.
65
+ - If Git is initialized but no GitHub remote exists, ask for the remote URL and offer `git remote add origin <url>`.
66
+ - If GitHub is connected, record the remote URL here and in `DECISION_LOG.md` when it changes.
67
+ - If domain or deployment details are missing, keep warning until they are confirmed.
68
+ - Treat missing domain, deployment, analytics, email, and privacy ownership as mission-critical launch risks, not as reasons to abandon the task.
69
+ - Never turn care warnings into fake blockers.
70
+
71
+ ## Current Care Warnings
72
+
73
+ - Project package file: package.json is missing. Action: Create package.json when implementation starts, unless this is not a Node project.
74
+ - Deployment target: No explicit deployment config detected. Action: Confirm deployment target, production domain, preview environment, and rollback path before launch.
75
+ - Environment template: .env.example is missing. Action: Add .env.example before sharing the project so required secrets are visible without exposing real values.
@@ -2,46 +2,22 @@
2
2
 
3
3
  This repository uses Gaslighting-engine.
4
4
 
5
- Before doing any work, read these files in order:
6
-
7
- 1. `GASLIGHTING.md`
8
- 2. `PRD.md`
9
- 3. `STACK_POLICY.md`
10
- 4. `MISSING_INFO.md`
11
- 5. `ASSUMPTIONS.md`
12
- 6. `DECISION_LOG.md`
13
- 7. `MEMORY.md`
14
-
15
- ## Prime Directive
16
-
17
- Do not forget the project purpose.
18
-
19
- Do not reduce the requested scope.
20
-
21
- Do not pretend partial work is complete.
22
-
23
- Do not use TODO comments as fake implementation.
5
+ The main discipline documents live under `.gaslighting/` to avoid cluttering the project root.
24
6
 
25
- Do not create representative examples when the user requested full coverage.
26
-
27
- Do not say "the rest follows the same pattern."
28
-
29
- If information is missing, make a reasonable assumption, document it, and continue unless the missing information is truly blocking.
30
-
31
- ## Completion Standard
32
-
33
- A task is complete only when:
7
+ Before doing any work, read these files in order:
34
8
 
35
- - The requested scope is fully handled.
36
- - No required item is silently skipped.
37
- - No placeholder is pretending to be implementation.
38
- - No TODO is used as a substitute for work.
39
- - The output can actually be used.
40
- - New assumptions are documented.
41
- - New technical decisions are recorded.
42
- - Stable project facts are recorded in `MEMORY.md`.
43
- - The result does not contradict `GASLIGHTING.md`.
9
+ 1. `.gaslighting/GASLIGHTING.md`
10
+ 2. `.gaslighting/PRD.md`
11
+ 3. `.gaslighting/STACK_POLICY.md`
12
+ 4. `.gaslighting/MISSING_INFO.md`
13
+ 5. `.gaslighting/ASSUMPTIONS.md`
14
+ 6. `.gaslighting/DECISION_LOG.md`
15
+ 7. `.gaslighting/MEMORY.md`
16
+ 8. `.gaslighting/PROJECT_CARE.md`
17
+ 9. `.gaslighting/AGENTS.md`
44
18
 
45
- If the task is incomplete, say it is incomplete.
19
+ Do not reduce scope.
46
20
 
47
21
  Do not fake completion.
22
+
23
+ If care risks are missing or unresolved, record them in `.gaslighting/PROJECT_CARE.md` and continue unless they truly block implementation.
@@ -2,14 +2,15 @@
2
2
 
3
3
  Read the Gaslighting-engine project-control files before doing any work:
4
4
 
5
- 1. `GASLIGHTING.md`
6
- 2. `PRD.md`
7
- 3. `STACK_POLICY.md`
8
- 4. `MISSING_INFO.md`
9
- 5. `ASSUMPTIONS.md`
10
- 6. `DECISION_LOG.md`
5
+ 1. `.gaslighting/GASLIGHTING.md`
6
+ 2. `.gaslighting/PRD.md`
7
+ 3. `.gaslighting/STACK_POLICY.md`
8
+ 4. `.gaslighting/MISSING_INFO.md`
9
+ 5. `.gaslighting/ASSUMPTIONS.md`
10
+ 6. `.gaslighting/DECISION_LOG.md`
11
11
  7. `AGENTS.md`
12
- 8. `MEMORY.md`
12
+ 8. `.gaslighting/MEMORY.md`
13
+ 9. `.gaslighting/PROJECT_CARE.md`
13
14
 
14
15
  Then execute the user's requested implementation.
15
16
 
@@ -23,8 +24,9 @@ Rules:
23
24
  - Do not call scaffolding completion.
24
25
  - Do not call placeholders implementation.
25
26
  - Do not over-engineer.
26
- - Record stable project facts in `MEMORY.md`.
27
- - Record product and technical decisions in `DECISION_LOG.md`.
27
+ - Record stable project facts in `.gaslighting/MEMORY.md`.
28
+ - Record product and technical decisions in `.gaslighting/DECISION_LOG.md`.
29
+ - Record Git/GitHub/domain/deployment risks in `.gaslighting/PROJECT_CARE.md`.
28
30
  - If something is incomplete, declare it explicitly.
29
31
 
30
- Before claiming completion, perform the self-audit in `GASLIGHTING.md`.
32
+ Before claiming completion, perform the self-audit in `.gaslighting/GASLIGHTING.md`.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gaslighting
3
- description: Generate or update strict project discipline documents for Codex and AI coding agents. Use when a user asks to initialize Gaslighting, create GASLIGHTING.md/PRD.md/AGENTS.md discipline files, preserve full project scope, prevent TODO escape, prevent fake completion, or turn vague project intent into actionable control documents.
3
+ description: Generate or update strict .gaslighting project discipline documents for Codex and AI coding agents. Use when a user asks to initialize Gaslighting, create GASLIGHTING.md/PRD.md/AGENTS.md discipline files, preserve full project scope, prevent TODO escape, prevent fake completion, track Git/GitHub/domain/deployment care risks, or turn vague project intent into actionable control documents.
4
4
  ---
5
5
 
6
6
  # Gaslighting-engine Skill
@@ -16,13 +16,14 @@ Instead:
16
16
  3. Make reasonable assumptions.
17
17
  4. Document assumptions clearly.
18
18
  5. Mark missing information clearly.
19
- 6. Generate `GASLIGHTING.md`.
20
- 7. Generate `PRD.md`.
21
- 8. Generate `ASSUMPTIONS.md`.
22
- 9. Generate `MISSING_INFO.md`.
23
- 10. Generate `DECISION_LOG.md`.
24
- 11. Generate `STACK_POLICY.md`.
25
- 12. Generate or update `AGENTS.md`.
19
+ 6. Generate `.gaslighting/GASLIGHTING.md`.
20
+ 7. Generate `.gaslighting/PRD.md`.
21
+ 8. Generate `.gaslighting/ASSUMPTIONS.md`.
22
+ 9. Generate `.gaslighting/MISSING_INFO.md`.
23
+ 10. Generate `.gaslighting/DECISION_LOG.md`.
24
+ 11. Generate `.gaslighting/STACK_POLICY.md`.
25
+ 12. Generate or update root `AGENTS.md`.
26
+ 13. Generate `.gaslighting/PROJECT_CARE.md`.
26
27
 
27
28
  ## Hardcore Discipline Rule
28
29
 
@@ -87,6 +88,10 @@ Avoid over-engineering.
87
88
 
88
89
  Create real markdown files.
89
90
 
91
+ Keep main project-control files in `.gaslighting/` and keep only the Codex pointer `AGENTS.md` in the repository root.
92
+
93
+ Use `.gaslighting/PROJECT_CARE.md` to track Git/GitHub/domain/deployment/launch risks without blocking implementation.
94
+
90
95
  Do not only explain.
91
96
 
92
97
  Do not produce a plan without files.
@@ -0,0 +1,49 @@
1
+ # AGENTS.md
2
+
3
+ This repository uses Gaslighting-engine.
4
+
5
+ Before doing any work, read these files in order:
6
+
7
+ 1. `.gaslighting/GASLIGHTING.md`
8
+ 2. `.gaslighting/PRD.md`
9
+ 3. `.gaslighting/STACK_POLICY.md`
10
+ 4. `.gaslighting/MISSING_INFO.md`
11
+ 5. `.gaslighting/ASSUMPTIONS.md`
12
+ 6. `.gaslighting/DECISION_LOG.md`
13
+ 7. `.gaslighting/MEMORY.md`
14
+ 8. `.gaslighting/PROJECT_CARE.md`
15
+
16
+ ## Prime Directive
17
+
18
+ Do not forget the project purpose.
19
+
20
+ Do not reduce the requested scope.
21
+
22
+ Do not pretend partial work is complete.
23
+
24
+ Do not use TODO comments as fake implementation.
25
+
26
+ Do not create representative examples when the user requested full coverage.
27
+
28
+ Do not say "the rest follows the same pattern."
29
+
30
+ If information is missing, make a reasonable assumption, document it, and continue unless the missing information is truly blocking.
31
+
32
+ ## Completion Standard
33
+
34
+ A task is complete only when:
35
+
36
+ - The requested scope is fully handled.
37
+ - No required item is silently skipped.
38
+ - No placeholder is pretending to be implementation.
39
+ - No TODO is used as a substitute for work.
40
+ - The output can actually be used.
41
+ - New assumptions are documented.
42
+ - New technical decisions are recorded.
43
+ - Stable project facts are recorded in `.gaslighting/MEMORY.md`.
44
+ - Operational risks are recorded in `.gaslighting/PROJECT_CARE.md`.
45
+ - The result does not contradict `.gaslighting/GASLIGHTING.md`.
46
+
47
+ If the task is incomplete, say it is incomplete.
48
+
49
+ Do not fake completion.
@@ -6,14 +6,15 @@ Copy and paste this into Codex:
6
6
 
7
7
  Read the following files before doing any work:
8
8
 
9
- 1. `GASLIGHTING.md`
10
- 2. `PRD.md`
11
- 3. `STACK_POLICY.md`
12
- 4. `MISSING_INFO.md`
13
- 5. `ASSUMPTIONS.md`
14
- 6. `DECISION_LOG.md`
9
+ 1. `.gaslighting/GASLIGHTING.md`
10
+ 2. `.gaslighting/PRD.md`
11
+ 3. `.gaslighting/STACK_POLICY.md`
12
+ 4. `.gaslighting/MISSING_INFO.md`
13
+ 5. `.gaslighting/ASSUMPTIONS.md`
14
+ 6. `.gaslighting/DECISION_LOG.md`
15
15
  7. `AGENTS.md`
16
- 8. `MEMORY.md`
16
+ 8. `.gaslighting/MEMORY.md`
17
+ 9. `.gaslighting/PROJECT_CARE.md`
17
18
 
18
19
  Then implement the project MVP.
19
20
 
@@ -29,6 +30,6 @@ Rules:
29
30
  - Do not forget the project purpose.
30
31
  - If something is incomplete, declare it explicitly.
31
32
 
32
- Before claiming completion, perform the self-audit in `GASLIGHTING.md`.
33
+ Before claiming completion, perform the self-audit in `.gaslighting/GASLIGHTING.md`.
33
34
 
34
35
  Proceed.
@@ -6,7 +6,7 @@ It is inspired by agent memory systems, but it is not a vague diary.
6
6
 
7
7
  It records stable project facts, recurring workflow rules, known failure patterns, and decisions that future AI-agent sessions must not forget.
8
8
 
9
- Keep required rules in `AGENTS.md`, `GASLIGHTING.md`, and checked-in documents. Treat this file as a compact recall layer, not the only source of truth.
9
+ Keep required rules in root `AGENTS.md`, `.gaslighting/GASLIGHTING.md`, and checked-in documents. Treat this file as a compact recall layer, not the only source of truth.
10
10
 
11
11
  ## Stable Project Facts
12
12
 
@@ -43,7 +43,7 @@ These are cleanup and verification rules:
43
43
  - Zero unexplained scope reductions.
44
44
  - Zero unverified success claims.
45
45
  - Every destructive cleanup must be intentional and explainable.
46
- - If code or files are removed, record why in `DECISION_LOG.md`.
46
+ - If code or files are removed, record why in `.gaslighting/DECISION_LOG.md`.
47
47
 
48
48
  ## Memory Write Rules
49
49
 
@@ -0,0 +1,119 @@
1
+ # PRD.md
2
+
3
+ ## 1. Product Overview
4
+
5
+ Build an MVP for this request:
6
+
7
+ > I want to build a hospital website.
8
+
9
+ Classified project type: `hospital_homepage`
10
+
11
+ The product must preserve the user's actual scope and must not become a decorative shell.
12
+
13
+ ## 2. Business Purpose
14
+
15
+ - increase trust
16
+ - generate consultation inquiries
17
+ - support reservation conversion
18
+ - make departments and treatments understandable
19
+ - make doctors and hospital credibility visible
20
+ - help mobile visitors contact the hospital quickly
21
+ - support local SEO
22
+ - make location and contact information obvious
23
+
24
+ ## 3. Target Users
25
+
26
+ - Potential patients searching on mobile
27
+ - Patients comparing hospitals
28
+ - Users looking for treatment information
29
+ - Users who want to call, reserve, or ask questions
30
+ - Hospital staff receiving inquiries
31
+
32
+ ## 4. User Flows
33
+
34
+ - Search/mobile visitor -> home -> treatment/doctor trust -> contact or reservation CTA
35
+ - Visitor -> location/contact -> call or submit inquiry
36
+
37
+ ## 5. Page List
38
+
39
+ - Home
40
+ - Hospital Introduction
41
+ - Departments / Treatments
42
+ - Doctor Profiles
43
+ - Consultation / Contact
44
+ - Location
45
+ - Privacy Policy
46
+
47
+ ## 6. Feature List
48
+
49
+ - responsive layout
50
+ - mobile-first UI
51
+ - contact CTA
52
+ - inquiry form
53
+ - treatment sections
54
+ - doctor introduction
55
+ - location section
56
+ - privacy policy
57
+ - SEO metadata
58
+ - analytics-ready structure
59
+
60
+ ## 7. Data Model Draft
61
+
62
+ - Inquiry: name, phone, category, message, privacyConsent, status, createdAt
63
+ - Treatment: title, summary, body, image, order
64
+ - Doctor: name, specialty, bio, credentials, image
65
+ - Location: address, phone, hours, mapUrl
66
+
67
+ ## 8. MVP Scope
68
+
69
+ - Implement all pages, flows, and features listed above.
70
+ - Include responsive behavior.
71
+ - Include useful empty, loading, success, and error states where applicable.
72
+ - Include SEO metadata where public pages exist.
73
+ - Include analytics-ready structure where conversion matters.
74
+ - Document every assumption that affects implementation.
75
+
76
+ ## 9. Out of Scope
77
+
78
+ - full admin dashboard
79
+ - payment
80
+ - complex reservation calendar
81
+ - EMR integration
82
+ - user login
83
+ - multilingual content
84
+ - automated medical diagnosis
85
+
86
+ ## 10. Non-Functional Requirements
87
+
88
+ - Mobile-first where users are likely to arrive from search or ads.
89
+ - Accessible semantic HTML.
90
+ - Fast initial load for public pages.
91
+ - Safe form validation and clear error messages.
92
+ - Maintainable TypeScript structure.
93
+ - No unnecessary distributed systems.
94
+
95
+ ## 11. Tech Stack
96
+
97
+ No stack hints were provided. Use the default practical web stack unless the user later changes it.
98
+
99
+ See `STACK_POLICY.md` for defaults and forbidden-by-default technology.
100
+
101
+ ## 12. Risks
102
+
103
+ - Vague source requirements can cause wrong vertical assumptions.
104
+ - Placeholder copy can look real if not reviewed.
105
+ - Missing production credentials can block deployment.
106
+ - AI agents may reduce scope unless `GASLIGHTING.md` is enforced.
107
+
108
+ ## 13. Missing Information
109
+
110
+ See `MISSING_INFO.md`.
111
+
112
+ ## 14. Success Criteria
113
+
114
+ - The project purpose is visible in the implemented product.
115
+ - The core pages and features are implemented, not merely described.
116
+ - No required scope is replaced by representative examples.
117
+ - No TODO is used as a substitute for implementation.
118
+ - Assumptions and decisions remain documented.
119
+ - The output can actually be used for the MVP purpose.