Skip to content

Commit c1e92bd

Browse files
author
xyjk
committed
Position services around Codex repo readiness
Add a concrete Codex workflow setup offer, intake fields for repo repair work, and a public checklist guide so the portfolio can capture AI-coded app rescue and repo-readiness leads. Constraint: service route must use public, sanitized intake and avoid credential/payment/private-data handling. Rejected: generic Codex consulting copy | fixed-scope offers with verification evidence are easier to sell and scope. Confidence: high Scope-risk: narrow Directive: keep service claims tied to deliverables and proof, not guaranteed business outcomes. Tested: python HTMLParser over index.html and guides/codex-repo-readiness-checklist.html Tested: python ElementTree parse sitemap.xml Tested: PyYAML safe_load .github/ISSUE_TEMPLATE/service-request.yml Tested: git diff --check Not-tested: live GitHub Pages deployment after push.
1 parent 73cac92 commit c1e92bd

6 files changed

Lines changed: 192 additions & 26 deletions

File tree

‎.github/ISSUE_TEMPLATE/service-request.yml‎

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name: Service request
2-
description: Request a quote for a small automation, code repair, or prototype task.
2+
description: Request a quote for a Codex workflow setup, small automation, code repair, or prototype task.
33
title: "[Quote] "
44
body:
55
- type: markdown
@@ -10,17 +10,19 @@ body:
1010
id: goal
1111
attributes:
1212
label: Goal
13-
description: What should the script, patch, or prototype do?
14-
placeholder: Compare two CSV exports and produce a mismatch report.
13+
description: What should the audit, script, patch, or prototype do?
14+
placeholder: Make this repo safer for Codex changes, or compare two CSV exports and produce a mismatch report.
1515
validations:
1616
required: true
1717
- type: dropdown
1818
id: service_type
1919
attributes:
2020
label: Service type
2121
options:
22+
- Codex repo readiness / AGENTS.md setup
2223
- CSV / Excel automation
2324
- Bug / test / CI repair
25+
- PR review / maintenance sprint
2426
- Small AI / RAG prototype
2527
- Other small fixed-scope task
2628
validations:
@@ -30,9 +32,11 @@ body:
3032
attributes:
3133
label: Budget range
3234
options:
33-
- $49 diagnostic
35+
- $99 repo audit
3436
- $50-$150 script or repair
3537
- $150-$250 workflow
38+
- $249 Codex workflow setup
39+
- $499 CI / PR verification workflow
3640
- $250+ prototype
3741
- Not sure yet
3842
validations:
@@ -44,6 +48,30 @@ body:
4448
description: Paste a tiny fake-data example or describe the input and desired output.
4549
validations:
4650
required: true
51+
- type: input
52+
id: repo_url
53+
attributes:
54+
label: Repository URL
55+
description: Public repo URL, or say private/not public if you only want a readiness checklist.
56+
placeholder: https://github.com/org/repo
57+
validations:
58+
required: false
59+
- type: textarea
60+
id: failing_commands
61+
attributes:
62+
label: Current commands or failure
63+
description: Paste the failing test/lint/build command and the shortest useful error excerpt.
64+
placeholder: npm test fails in packages/app/src/foo.test.ts
65+
validations:
66+
required: false
67+
- type: textarea
68+
id: acceptance
69+
attributes:
70+
label: Acceptance criteria
71+
description: What proof would make this job done?
72+
placeholder: The failing test passes, npm run build passes, and the README explains the command.
73+
validations:
74+
required: false
4775
- type: input
4876
id: deadline
4977
attributes:

‎README.md‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Small Automation and Code Repair Services
1+
# Codex Repo Rescue and Code Repair Services
22

33
Live portfolio:
44
https://xyjk0511.github.io/codex-services-portfolio/
@@ -9,7 +9,8 @@ https://github.com/xyjk0511/codex-services-portfolio/issues/1
99
## Available Services
1010

1111
- CSV and Excel automation: typical small scope $50-$150
12-
- Bug fix and test repair: $25-$250 depending on scope
12+
- Codex repo readiness audit: $99 audit, $249 setup, $499 workflow
13+
- Bug fix, test repair, and PR review: $79 triage, $199+ one-flow rescue
1314
- Small chatbot or RAG prototypes from provided content: $99 audit, $250+ prototype
1415

1516
The CSV kit page is a public preview only. The paid zip is not linked from this
@@ -21,6 +22,8 @@ repository.
2122
https://xyjk0511.github.io/codex-services-portfolio/csv-kit/
2223
- CSV reconciliation checklist:
2324
https://xyjk0511.github.io/codex-services-portfolio/guides/csv-reconciliation-checklist.html
25+
- Codex repo readiness checklist:
26+
https://xyjk0511.github.io/codex-services-portfolio/guides/codex-repo-readiness-checklist.html
2427
- Sample JSON summary:
2528
https://xyjk0511.github.io/codex-services-portfolio/csv-kit/sample-output/summary.json
2629
- Sample mismatch CSV:

‎guides/codex-repo-readiness-checklist.html‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
<!doctype html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="utf-8">
5+
<meta name="viewport" content="width=device-width, initial-scale=1">
6+
<title>Codex Repo Readiness Checklist</title>
7+
<meta
8+
name="description"
9+
content="A practical checklist for making a repository safer and easier to modify with Codex or another coding agent."
10+
>
11+
<link rel="canonical" href="https://xyjk0511.github.io/codex-services-portfolio/guides/codex-repo-readiness-checklist.html">
12+
<link rel="stylesheet" href="../styles.css">
13+
</head>
14+
<body>
15+
<main class="article-page">
16+
<p class="eyebrow">Guide</p>
17+
<h1>Codex repo readiness checklist.</h1>
18+
<p>
19+
A coding agent works best when the repository tells it what matters,
20+
how to verify changes, and where not to make risky guesses. This is the
21+
checklist I use before a repo becomes a good candidate for fixed-scope
22+
AI-assisted repair work.
23+
</p>
24+
25+
<section>
26+
<h2>1. Define the command map</h2>
27+
<p>
28+
Put the real setup, test, lint, typecheck, build, and smoke commands
29+
in one place. Include the package manager and expected runtime
30+
version. A command map prevents slow discovery and makes every patch
31+
easier to verify.
32+
</p>
33+
<pre><code>Setup: npm install
34+
Tests: npm test -- --runInBand
35+
Lint: npm run lint
36+
Build: npm run build
37+
Smoke: npm run dev, then open /health</code></pre>
38+
</section>
39+
40+
<section>
41+
<h2>2. Write the agent contract</h2>
42+
<p>
43+
Add an AGENTS.md or contributor note that states coding style,
44+
ownership boundaries, verification expectations, no-go areas, and
45+
how to handle generated files. This is especially useful when more
46+
than one agent or developer touches the repo.
47+
</p>
48+
<ul class="article-list">
49+
<li>What files are source of truth?</li>
50+
<li>Which generated files should not be hand edited?</li>
51+
<li>Which tests prove a normal patch?</li>
52+
<li>Which actions require maintainer approval?</li>
53+
</ul>
54+
</section>
55+
56+
<section>
57+
<h2>3. Make failures reproducible</h2>
58+
<p>
59+
A good repair request includes the failing command, the observed
60+
error, the expected behavior, and a small input or route that triggers
61+
the bug. Without that, the first paid hour becomes archaeology.
62+
</p>
63+
</section>
64+
65+
<section>
66+
<h2>4. Keep secrets out of the workflow</h2>
67+
<p>
68+
Use sample env files and fake fixtures. Do not send production
69+
credentials, customer data, private keys, payment details, or
70+
anything you are not allowed to share. If live credentials are needed,
71+
the work is not a fixed-scope public intake job.
72+
</p>
73+
</section>
74+
75+
<section>
76+
<h2>5. Require proof with every patch</h2>
77+
<p>
78+
The final handoff should say what changed, what command proved it,
79+
and what was not tested. This keeps Codex-assisted work closer to a
80+
reviewable engineering change than a vague code dump.
81+
</p>
82+
</section>
83+
84+
<section class="article-cta">
85+
<h2>Want this applied to a repo?</h2>
86+
<p>
87+
Send a sanitized repo link, failing command, and target outcome. I
88+
can turn it into a short readiness report, AGENTS.md patch, and
89+
verification checklist.
90+
</p>
91+
<a class="button primary" href="https://github.com/xyjk0511/codex-services-portfolio/issues/1">Request a quote</a>
92+
<a class="button secondary" href="../index.html">Back to services</a>
93+
</section>
94+
</main>
95+
</body>
96+
</html>

‎index.html‎

Lines changed: 51 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -3,35 +3,46 @@
33
<head>
44
<meta charset="utf-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1">
6-
<title>Python Automation, CSV Cleanup, and Code Repair Services</title>
6+
<title>Codex Repo Rescue, Python Automation, and Code Repair Services</title>
77
<meta
88
name="description"
9-
content="Fixed-scope Python automation, CSV and Excel cleanup, bug fixes, test repair, and small AI workflow prototypes."
9+
content="Fixed-scope Codex repo rescue, AGENTS.md setup, Python automation, bug fixes, test repair, and small AI workflow prototypes."
1010
>
1111
<meta name="robots" content="index,follow">
1212
<link rel="canonical" href="https://xyjk0511.github.io/codex-services-portfolio/">
13-
<meta property="og:title" content="Small Automation and Code Repair Work">
14-
<meta property="og:description" content="Fixed-scope CSV and Excel automation, bug fixes, test repair, and small AI workflow prototypes with clear verification evidence.">
13+
<meta property="og:title" content="Codex Repo Rescue and Code Repair Work">
14+
<meta property="og:description" content="Fixed-scope Codex workflow setup, CSV automation, bug fixes, test repair, and small AI workflow prototypes with clear verification evidence.">
1515
<meta property="og:type" content="website">
1616
<meta property="og:url" content="https://xyjk0511.github.io/codex-services-portfolio/">
1717
<meta property="og:image" content="https://xyjk0511.github.io/codex-services-portfolio/assets/csv-kit-cover-1600x900.png">
1818
<meta name="twitter:card" content="summary_large_image">
19-
<meta name="twitter:title" content="Python Automation, CSV Cleanup, and Code Repair Services">
20-
<meta name="twitter:description" content="Fixed-scope CSV and Excel automation, bug fixes, test repair, and small AI workflow prototypes with clear verification evidence.">
19+
<meta name="twitter:title" content="Codex Repo Rescue, Python Automation, and Code Repair Services">
20+
<meta name="twitter:description" content="Fixed-scope Codex workflow setup, CSV automation, bug fixes, test repair, and small AI workflow prototypes with clear verification evidence.">
2121
<meta name="twitter:image" content="https://xyjk0511.github.io/codex-services-portfolio/assets/csv-kit-cover-1600x900.png">
2222
<link rel="stylesheet" href="styles.css">
2323
<script type="application/ld+json">
2424
{
2525
"@context": "https://schema.org",
2626
"@type": "ProfessionalService",
27-
"name": "Small Automation and Code Repair Work",
27+
"name": "Codex Repo Rescue and Code Repair Work",
2828
"url": "https://xyjk0511.github.io/codex-services-portfolio/",
29-
"description": "Fixed-scope Python automation, CSV and Excel cleanup, bug fixes, test repair, and small AI workflow prototypes.",
29+
"description": "Fixed-scope Codex repo rescue, AGENTS.md setup, Python automation, bug fixes, test repair, and small AI workflow prototypes.",
3030
"areaServed": "Remote",
3131
"sameAs": [
3232
"https://github.com/xyjk0511/codex-services-portfolio"
3333
],
3434
"offers": [
35+
{
36+
"@type": "Offer",
37+
"name": "Codex repo readiness audit",
38+
"priceCurrency": "USD",
39+
"priceSpecification": {
40+
"@type": "PriceSpecification",
41+
"minPrice": 99,
42+
"maxPrice": 499,
43+
"priceCurrency": "USD"
44+
}
45+
},
3546
{
3647
"@type": "Offer",
3748
"name": "CSV and Excel automation",
@@ -63,11 +74,12 @@
6374
<section class="hero" aria-labelledby="page-title">
6475
<div class="hero-copy">
6576
<p class="eyebrow">Fixed-scope remote work</p>
66-
<h1 id="page-title">Small automation, data cleanup, and code repair.</h1>
77+
<h1 id="page-title">Codex-ready repos, small automation, and code repair.</h1>
6778
<p class="lede">
68-
Practical help for founders, operators, and small teams that need a
69-
runnable script, a repaired test suite, or a narrow AI workflow
70-
prototype without a long agency process.
79+
Practical help for founders, operators, and small teams that need
80+
a repo made safer for AI coding agents, a runnable script, a
81+
repaired test suite, or a narrow AI workflow prototype without a
82+
long agency process.
7183
</p>
7284
<div class="actions" aria-label="Primary actions">
7385
<a class="button primary" href="https://github.com/xyjk0511/codex-services-portfolio/issues/1">Request a quote</a>
@@ -92,7 +104,7 @@ <h1 id="page-title">Small automation, data cleanup, and code repair.</h1>
92104
<section class="proof-strip" aria-label="Working boundaries">
93105
<div>
94106
<span>Starting scope</span>
95-
<strong>$49 diagnostics</strong>
107+
<strong>$99 repo audit</strong>
96108
</div>
97109
<div>
98110
<span>Small scripts</span>
@@ -111,9 +123,25 @@ <h1 id="page-title">Small automation, data cleanup, and code repair.</h1>
111123
<section id="services" class="service-section" aria-labelledby="services-title">
112124
<div class="section-heading">
113125
<p class="eyebrow">Services</p>
114-
<h2 id="services-title">Three offers with clear deliverables.</h2>
126+
<h2 id="services-title">Four offers with clear deliverables.</h2>
115127
</div>
116128
<div class="service-grid">
129+
<article class="service-card">
130+
<p class="tag">Codex / repo workflow</p>
131+
<h3>Codex repo readiness audit</h3>
132+
<p>
133+
A focused pass that makes an existing repo easier and safer to
134+
work on with Codex: command map, AGENTS.md guidance, test gates,
135+
PR checklist, and a short risk report.
136+
</p>
137+
<ul>
138+
<li>Current build/test/lint commands mapped</li>
139+
<li>AGENTS.md or contributor workflow patch</li>
140+
<li>Verification checklist for future PRs</li>
141+
</ul>
142+
<strong class="price">$99 audit, $249 setup, $499 workflow</strong>
143+
</article>
144+
117145
<article class="service-card">
118146
<p class="tag">Python / spreadsheets</p>
119147
<h3>CSV and Excel automation</h3>
@@ -132,18 +160,18 @@ <h3>CSV and Excel automation</h3>
132160

133161
<article class="service-card">
134162
<p class="tag">Repos / CI</p>
135-
<h3>Bug fix and test repair</h3>
163+
<h3>Bug fix, test repair, or PR review</h3>
136164
<p>
137165
Focused fixes for failing tests, broken builds, small React or
138-
Python bugs, GitHub Actions failures, and code paths that need a
139-
reproducible before/after result.
166+
Python bugs, GitHub Actions failures, stale PRs, and code paths
167+
that need a reproducible before/after result.
140168
</p>
141169
<ul>
142170
<li>Issue reproduction</li>
143171
<li>Root-cause summary</li>
144-
<li>Patch with targeted verification</li>
172+
<li>Patch or review report with targeted verification</li>
145173
</ul>
146-
<strong class="price">$25-$250 depending on scope</strong>
174+
<strong class="price">$79 triage, $199+ one-flow rescue</strong>
147175
</article>
148176

149177
<article class="service-card">
@@ -178,6 +206,10 @@ <h2 id="workflow-title">How a small job starts.</h2>
178206
<a class="text-link" href="guides/csv-reconciliation-checklist.html">
179207
Read the CSV reconciliation checklist
180208
</a>
209+
<span aria-hidden="true"> · </span>
210+
<a class="text-link" href="guides/codex-repo-readiness-checklist.html">
211+
Read the Codex repo readiness checklist
212+
</a>
181213
</p>
182214
</section>
183215

‎sitemap.xml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,4 +9,7 @@
99
<url>
1010
<loc>https://xyjk0511.github.io/codex-services-portfolio/guides/csv-reconciliation-checklist.html</loc>
1111
</url>
12+
<url>
13+
<loc>https://xyjk0511.github.io/codex-services-portfolio/guides/codex-repo-readiness-checklist.html</loc>
14+
</url>
1215
</urlset>

‎styles.css‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ h2 {
186186

187187
.service-grid {
188188
display: grid;
189-
grid-template-columns: repeat(3, 1fr);
189+
grid-template-columns: repeat(4, 1fr);
190190
gap: 16px;
191191
}
192192

@@ -210,6 +210,10 @@ h2 {
210210
border-top-color: var(--gold);
211211
}
212212

213+
.service-card:nth-child(4) {
214+
border-top-color: var(--green);
215+
}
216+
213217
.service-card h3 {
214218
margin-bottom: 0;
215219
font-size: 26px;

0 commit comments

Comments
 (0)