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.
- package/.agents/prompts/gaslighting.md +32 -0
- package/.agents/skills/gaslighting/SKILL.md +101 -0
- package/.agents/skills/gaslighting/agents/openai.yaml +8 -0
- package/.agents/skills/gaslighting/references/GASLIGHTING_TEMPLATE.md +425 -0
- package/.agents/skills/gaslighting/references/HARDCORE_DISCIPLINE_TEMPLATE.md +425 -0
- package/.agents/skills/gaslighting/scripts/generate-gaslighting-docs.ts +3 -0
- package/.codex/prompts/gaslighting.md +12 -10
- package/.codex/skills/gaslighting/SKILL.md +13 -8
- package/README.md +60 -10
- package/dist/cli.js +13 -2
- package/dist/commands/care.js +33 -0
- package/dist/commands/codexInstall.js +2 -2
- package/dist/commands/doctor.js +17 -11
- package/dist/commands/init.js +5 -3
- package/dist/commands/update.js +12 -5
- package/dist/core/generateDocs.js +54 -12
- package/dist/core/generateOtherMarkdown.js +47 -37
- package/dist/core/projectCare.js +135 -0
- package/dist/index.js +2 -0
- package/dist/utils/logger.js +10 -2
- package/dist/utils/updateCheck.js +61 -0
- package/dist/version.js +2 -0
- package/docs/codex-usage.md +4 -4
- package/docs/examples.md +14 -0
- package/examples/ecommerce/.codex/prompts/gaslighting.md +12 -10
- package/examples/ecommerce/.codex/skills/gaslighting/SKILL.md +13 -8
- package/examples/ecommerce/.gaslighting/AGENTS.md +49 -0
- package/examples/{landing-page → ecommerce/.gaslighting}/CODEX_PROMPT.md +9 -8
- package/examples/ecommerce/{MEMORY.md → .gaslighting/MEMORY.md} +2 -2
- package/examples/ecommerce/.gaslighting/PROJECT_CARE.md +75 -0
- package/examples/ecommerce/AGENTS.md +14 -38
- package/examples/hospital-homepage/.codex/prompts/gaslighting.md +12 -10
- package/examples/hospital-homepage/.codex/skills/gaslighting/SKILL.md +13 -8
- package/examples/hospital-homepage/.gaslighting/AGENTS.md +49 -0
- package/examples/{ecommerce → hospital-homepage/.gaslighting}/CODEX_PROMPT.md +9 -8
- package/examples/hospital-homepage/{MEMORY.md → .gaslighting/MEMORY.md} +2 -2
- package/examples/hospital-homepage/.gaslighting/PRD.md +119 -0
- package/examples/hospital-homepage/.gaslighting/PROJECT_CARE.md +75 -0
- package/examples/hospital-homepage/AGENTS.md +14 -38
- package/examples/landing-page/.codex/prompts/gaslighting.md +12 -10
- package/examples/landing-page/.codex/skills/gaslighting/SKILL.md +13 -8
- package/examples/landing-page/.gaslighting/AGENTS.md +49 -0
- package/examples/{hospital-homepage → landing-page/.gaslighting}/CODEX_PROMPT.md +9 -8
- package/examples/landing-page/{MEMORY.md → .gaslighting/MEMORY.md} +2 -2
- package/examples/landing-page/.gaslighting/PROJECT_CARE.md +74 -0
- package/examples/landing-page/.gaslighting/STACK_POLICY.md +64 -0
- package/examples/landing-page/AGENTS.md +14 -38
- package/package.json +2 -1
- /package/{examples/hospital-homepage/PRD.md → .agents/skills/gaslighting/references/HOSPITAL_HOMEPAGE_EXAMPLE.md} +0 -0
- /package/{examples/ecommerce/STACK_POLICY.md → .agents/skills/gaslighting/references/STACK_POLICY_TEMPLATE.md} +0 -0
- /package/examples/ecommerce/{ASSUMPTIONS.md → .gaslighting/ASSUMPTIONS.md} +0 -0
- /package/examples/ecommerce/{DECISION_LOG.md → .gaslighting/DECISION_LOG.md} +0 -0
- /package/examples/ecommerce/{GASLIGHTING.md → .gaslighting/GASLIGHTING.md} +0 -0
- /package/examples/ecommerce/{MISSING_INFO.md → .gaslighting/MISSING_INFO.md} +0 -0
- /package/examples/ecommerce/{PRD.md → .gaslighting/PRD.md} +0 -0
- /package/examples/{hospital-homepage → ecommerce/.gaslighting}/STACK_POLICY.md +0 -0
- /package/examples/hospital-homepage/{ASSUMPTIONS.md → .gaslighting/ASSUMPTIONS.md} +0 -0
- /package/examples/hospital-homepage/{DECISION_LOG.md → .gaslighting/DECISION_LOG.md} +0 -0
- /package/examples/hospital-homepage/{GASLIGHTING.md → .gaslighting/GASLIGHTING.md} +0 -0
- /package/examples/hospital-homepage/{MISSING_INFO.md → .gaslighting/MISSING_INFO.md} +0 -0
- /package/examples/{landing-page → hospital-homepage/.gaslighting}/STACK_POLICY.md +0 -0
- /package/examples/landing-page/{ASSUMPTIONS.md → .gaslighting/ASSUMPTIONS.md} +0 -0
- /package/examples/landing-page/{DECISION_LOG.md → .gaslighting/DECISION_LOG.md} +0 -0
- /package/examples/landing-page/{GASLIGHTING.md → .gaslighting/GASLIGHTING.md} +0 -0
- /package/examples/landing-page/{MISSING_INFO.md → .gaslighting/MISSING_INFO.md} +0 -0
- /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.
|
|
6
|
-
2.
|
|
7
|
-
3.
|
|
8
|
-
4.
|
|
9
|
-
5.
|
|
10
|
-
6.
|
|
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.
|
|
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
|
|
27
|
-
- Record product and technical decisions in
|
|
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
|
|
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
|
|
20
|
-
7. Generate
|
|
21
|
-
8. Generate
|
|
22
|
-
9. Generate
|
|
23
|
-
10. Generate
|
|
24
|
-
11. Generate
|
|
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.
|
|
10
|
-
2.
|
|
11
|
-
3.
|
|
12
|
-
4.
|
|
13
|
-
5.
|
|
14
|
-
6.
|
|
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.
|
|
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
|
|
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`,
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
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
|
-
|
|
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.
|
|
6
|
-
2.
|
|
7
|
-
3.
|
|
8
|
-
4.
|
|
9
|
-
5.
|
|
10
|
-
6.
|
|
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.
|
|
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
|
|
27
|
-
- Record product and technical decisions in
|
|
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
|
|
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
|
|
20
|
-
7. Generate
|
|
21
|
-
8. Generate
|
|
22
|
-
9. Generate
|
|
23
|
-
10. Generate
|
|
24
|
-
11. Generate
|
|
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.
|
|
10
|
-
2.
|
|
11
|
-
3.
|
|
12
|
-
4.
|
|
13
|
-
5.
|
|
14
|
-
6.
|
|
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.
|
|
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
|
|
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`,
|
|
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
|
|
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.
|