www-phcdevworks-com is the public company website for PHCDevworks. It
serves as the web presence for the company, its products, its technical
ecosystem, and its broader brand — showcasing Spectre prominently without
being framed as a single-product website.
Maintained by PHCDevworks. It represents PHCDevworks as a company first, with Spectre as one platform within that story rather than the whole story.
| Field | Value |
|---|---|
| Project team | project-web |
| Repository role | PHCDevworks public company website |
| Package/artifact | www-phcdevworks-com |
| Current version/status | 0.0.1 |
- Read AGENTS.md, then the agent-specific guide for the task.
- Check TODO.md and ROADMAP.md for current scope.
- Make the smallest repo-local change that satisfies the task.
- Run
npm run checkwhen validation is required or practical. - Update docs and CHANGELOG.md only when behavior, public contracts, or release-relevant metadata changed.
| Guide | Path |
|---|---|
| Agent rules | AGENTS.md |
| Claude Code | CLAUDE.md |
| Codex | CODEX.md |
| Copilot | COPILOT.md |
| Jules | JULES.md |
| Grok | GROK.md |
| Roadmap | ROADMAP.md |
| Todo | TODO.md |
| Changelog | CHANGELOG.md |
| Security | SECURITY.md |
www-phcdevworks-com is the public company website for PHCDevworks.
It serves as the web presence for the company, its products, its technical ecosystem, and its broader brand. The site may showcase Spectre prominently, but it is not limited to Spectre and should not be framed as a single-product website.
Repository docs: CONTRIBUTING.md | CHANGELOG.md | ROADMAP.md | SECURITY.md | BRAND.md | AGENTS.md | CLAUDE.md | CODEX.md | JULES.md | COPILOT.md | GROK.md | LICENSE
This repository contains the Astro-based marketing and company website for PHCDevworks.
It is responsible for presenting the company clearly and credibly across areas such as:
- company positioning
- product and ecosystem visibility
- technical capabilities
- brand communication
- public-facing pages, calls to action, and supporting content
Spectre is part of that story, but this repository represents the broader PHCDevworks identity and should be maintained with that scope in mind.
This site is the flagship public website for PHCDevworks. It was scaffolded
from the @phcdevworks/spectre-init astro template and depends on
@phcdevworks/spectre-tokens, @phcdevworks/spectre-ui, and
@phcdevworks/spectre-ui-astro for Spectre-aligned presentation. It does not
define upstream design tokens or UI package internals.
The site owns the company story; Spectre owns the system. Pages are built from
published spectre-ui-astro components and shipped sp-* classes, with no
site-authored design system. See "Spectre-First Building" in
AGENTS.md.
spectre.manifest.json describes the site's Spectre
dependencies for tooling and AI agents, and is validated by
@phcdevworks/spectre-manifest as part of npm run check.
- Maintain the PHCDevworks public company website.
- Update contributor-facing repository docs.
- Adjust site build, preview, deployment, or workspace configuration.
- Keep automation guidance aligned across Claude Code, Codex, Copilot, Jules, and Grok.
- Do not define Spectre token contracts here.
- Do not implement source components for
@phcdevworks/spectre-ui. - Do not narrow company-wide positioning to a single-product Spectre framing —
see
AGENTS.mdandBRAND.md.
- Astro 7 (static output; no hosting adapter configured yet)
- TypeScript 7
@phcdevworks/spectre-tokens,@phcdevworks/spectre-ui,@phcdevworks/spectre-ui-astro@phcdevworks/spectre-manifest(dev) for manifest validation
- Node.js 22.12 or newer
- npm
npm installnpm run dev| Script | What it does |
|---|---|
npm run dev |
Start the local Astro development server |
npm run build |
Create the production build in dist/ |
npm run preview |
Serve the production build locally |
npm run manifest:validate |
Validate spectre.manifest.json with spectre-manifest-validate |
npm run check |
Full validation gate — runs npm run build then npm run manifest:validate |
npm run checknpm run check runs the production build then validates
spectre.manifest.json. Use it before any handoff.
Build fails with missing module errors — run npm install first; dist/
is not committed and must be rebuilt locally.
Manifest validation fails — confirm the www-phcdevworks-com package
entry's dependencies in spectre.manifest.json still matches the
@phcdevworks/* dependencies in package.json.
| Path | Responsibility |
|---|---|
src/pages/ |
Route-level pages |
src/layouts/ |
Page layout components; BaseLayout.astro loads spectre-ui CSS |
astro.config.ts |
Astro configuration |
spectre.manifest.json |
App manifest describing this site's Spectre dependencies |
- Claude Code leads primary implementation. See CLAUDE.md.
- Codex handles documentation, releases, production stabilization, repo hygiene, and config standardization. See CODEX.md.
- GitHub Copilot provides general development assistance. See COPILOT.md and .github/copilot-instructions.md.
- Google Jules handles small automated maintenance. See JULES.md.
- xAI Grok (and Grok Bot) assists with development and commits its own work. See GROK.md.
- Follow
BRAND.mdbefore changing public site structure, copy, or visual direction.
Claude Code has no git access in this repository; Codex executes git operations for its handed-off work. Site deployment remains Bradley Potts's sole authority. See AGENTS.md for the full commit-policy and release-authority grant.
Shared coordination rules live in AGENTS.md.
Track release-relevant documentation, workflow, and configuration changes in CHANGELOG.md.
See CONTRIBUTING.md.
See LICENSE.
PHCDevworks owns and maintains this repository. This repository should use PHCDevworks company-first naming and positioning consistently across docs, settings, and project configuration. Spectre is part of the PHCDevworks ecosystem, not the sole identity of this site.