gaslighting-engine 0.2.1 → 0.3.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 +4 -1
- package/.agents/skills/gaslighting/SKILL.md +12 -1
- package/.codex/prompts/gaslighting.md +4 -1
- package/.codex/skills/gaslighting/SKILL.md +12 -1
- package/README.md +46 -3
- package/dist/cli.js +48 -1
- package/dist/commands/cockpit.js +174 -0
- package/dist/commands/codexInstall.js +3 -2
- package/dist/commands/doctor.js +1 -0
- package/dist/commands/upgrade.js +27 -0
- package/dist/core/cockpitHtml.js +596 -0
- package/dist/core/codexRuntime.js +74 -0
- package/dist/core/generateDocs.js +5 -3
- package/dist/core/generateOtherMarkdown.js +84 -4
- package/dist/index.js +1 -1
- package/dist/utils/logger.js +1 -1
- package/dist/utils/updateCheck.js +1 -2
- package/dist/version.js +1 -1
- package/docs/codex-usage.md +24 -4
- package/docs/examples.md +4 -0
- package/examples/ecommerce/.codex/prompts/gaslighting.md +4 -1
- package/examples/ecommerce/.codex/skills/gaslighting/SKILL.md +12 -1
- package/examples/ecommerce/.gaslighting/AGENTS.md +3 -1
- package/examples/ecommerce/.gaslighting/AGENT_RUNTIME.md +54 -0
- package/examples/ecommerce/.gaslighting/CODEX_PROMPT.md +8 -1
- package/examples/ecommerce/AGENTS.md +3 -2
- package/examples/hospital-homepage/.codex/prompts/gaslighting.md +4 -1
- package/examples/hospital-homepage/.codex/skills/gaslighting/SKILL.md +12 -1
- package/examples/hospital-homepage/.gaslighting/AGENTS.md +3 -1
- package/examples/hospital-homepage/.gaslighting/AGENT_RUNTIME.md +54 -0
- package/examples/hospital-homepage/.gaslighting/CODEX_PROMPT.md +8 -1
- package/examples/hospital-homepage/AGENTS.md +3 -2
- package/examples/landing-page/.codex/prompts/gaslighting.md +4 -1
- package/examples/landing-page/.codex/skills/gaslighting/SKILL.md +12 -1
- package/examples/landing-page/.gaslighting/AGENTS.md +3 -1
- package/examples/landing-page/.gaslighting/AGENT_RUNTIME.md +54 -0
- package/examples/landing-page/.gaslighting/CODEX_PROMPT.md +8 -1
- package/examples/landing-page/AGENTS.md +3 -2
- package/package.json +1 -1
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# AGENT_RUNTIME.md
|
|
2
|
+
|
|
3
|
+
This file defines how Codex must operate after Gaslighting-engine prepares the project.
|
|
4
|
+
|
|
5
|
+
It is not a suggestion file.
|
|
6
|
+
|
|
7
|
+
It is the runtime loop.
|
|
8
|
+
|
|
9
|
+
## Mission
|
|
10
|
+
|
|
11
|
+
- Original request: Build a landing page for a new service that captures leads.
|
|
12
|
+
- Project type: landing_page
|
|
13
|
+
- Classification confidence: high
|
|
14
|
+
- Runtime stance: Codex-first, full-scope, no fake completion.
|
|
15
|
+
|
|
16
|
+
## Required Loop
|
|
17
|
+
|
|
18
|
+
1. Read the control files before implementation.
|
|
19
|
+
2. Restate the project purpose in one short paragraph.
|
|
20
|
+
3. Convert the PRD into a concrete task checklist.
|
|
21
|
+
4. Implement the checklist systematically.
|
|
22
|
+
5. Use scripts or structured data for repetitive work.
|
|
23
|
+
6. Verify the result with build, tests, lint, browser checks, or direct inspection as appropriate.
|
|
24
|
+
7. Update `.gaslighting/DECISION_LOG.md` when a product or technical decision changes.
|
|
25
|
+
8. Update `.gaslighting/MISSING_INFO.md` when missing information is discovered or resolved.
|
|
26
|
+
9. Update `.gaslighting/MEMORY.md` when stable project facts are learned.
|
|
27
|
+
10. Update `.gaslighting/PROJECT_CARE.md` when GitHub, domain, deployment, env, analytics, email, or launch ownership changes.
|
|
28
|
+
|
|
29
|
+
## Agent Rules
|
|
30
|
+
|
|
31
|
+
- Do not ask the user for non-blocking information before starting work.
|
|
32
|
+
- Do make a reasonable temporary assumption, document it, and continue.
|
|
33
|
+
- Do not create only the visible surface and ignore operational details.
|
|
34
|
+
- Do not stop at a plan when implementation was requested.
|
|
35
|
+
- Do not call a scaffold complete.
|
|
36
|
+
- Do not call TODO comments implementation.
|
|
37
|
+
- Do not call examples full coverage.
|
|
38
|
+
- Do not hide risk behind confident wording.
|
|
39
|
+
- Do not over-engineer to look sophisticated.
|
|
40
|
+
- Do not under-deliver because the work is repetitive.
|
|
41
|
+
|
|
42
|
+
## Codex Execution Contract
|
|
43
|
+
|
|
44
|
+
Before claiming completion, Codex must be able to answer:
|
|
45
|
+
|
|
46
|
+
- What exact requested scope was completed?
|
|
47
|
+
- What exact files changed?
|
|
48
|
+
- What verification was run?
|
|
49
|
+
- What assumptions are still active?
|
|
50
|
+
- What missing information remains?
|
|
51
|
+
- What care risks remain?
|
|
52
|
+
- Is anything incomplete?
|
|
53
|
+
|
|
54
|
+
If anything is incomplete, use the failure declaration protocol in `.gaslighting/GASLIGHTING.md`.
|
|
@@ -14,7 +14,8 @@ Read the following files before doing any work:
|
|
|
14
14
|
6. `.gaslighting/DECISION_LOG.md`
|
|
15
15
|
7. `AGENTS.md`
|
|
16
16
|
8. `.gaslighting/MEMORY.md`
|
|
17
|
-
9. `.gaslighting/
|
|
17
|
+
9. `.gaslighting/AGENT_RUNTIME.md`
|
|
18
|
+
10. `.gaslighting/PROJECT_CARE.md`
|
|
18
19
|
|
|
19
20
|
Then implement the project MVP.
|
|
20
21
|
|
|
@@ -32,4 +33,10 @@ Rules:
|
|
|
32
33
|
|
|
33
34
|
Before claiming completion, perform the self-audit in `.gaslighting/GASLIGHTING.md`.
|
|
34
35
|
|
|
36
|
+
To refresh the Codex skill files later, run:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
npx gaslighting-engine@latest upgrade
|
|
40
|
+
```
|
|
41
|
+
|
|
35
42
|
Proceed.
|
|
@@ -13,8 +13,9 @@ Before doing any work, read these files in order:
|
|
|
13
13
|
5. `.gaslighting/ASSUMPTIONS.md`
|
|
14
14
|
6. `.gaslighting/DECISION_LOG.md`
|
|
15
15
|
7. `.gaslighting/MEMORY.md`
|
|
16
|
-
8. `.gaslighting/
|
|
17
|
-
9. `.gaslighting/
|
|
16
|
+
8. `.gaslighting/AGENT_RUNTIME.md`
|
|
17
|
+
9. `.gaslighting/PROJECT_CARE.md`
|
|
18
|
+
10. `.gaslighting/AGENTS.md`
|
|
18
19
|
|
|
19
20
|
Do not reduce scope.
|
|
20
21
|
|